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**** The North Star ADVANTAGE Graphics CP/M preface is 
copyrighted by North Star Computers, Inc. All rights 
are reserved. No license to copy or duplicate this 
manual is granted with distribution or sale. You can 
make duplicates of the programs described within this 
preface for your use only, not for sale or 
distribution to others. 

We have tried to ensure the accuracy of the material 
presented here. However, if you find any errors, or 
have suggestions for improvements to this preface, 
please write to North Star at this address: 

NORTH STAR COMPUTERS, INC. 
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14440 CATALINA STREET 
SAN LEANDRO, CA. , 94577 
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START-UP PROCEDURE FOR THE STANDARD ADVANTAGE 



This section provides a complete start-up procedure 
for the standard ADVANTAGE with two floppy disk 
drives. If you have a hard disk ADVANTAGE f with one 
floppy disk drive and one hard disk drive f you should 
use the start-up procedure in Section 3. 

2.1 INSERT GRAPHICS CP/M SYSTEM DISKETTE 

Turn the ADVANTAGE on by pressing the on/off switch on 
the back of the computer. A quiet "beep" sounds, the 
red light on the ALL CAPS key comes on, and the 

LOAD SYSTEM 

message appears. Beneath it, a cursor is displayed on 
the video screen. 



TWO IMPORTANT PRECAUTIONS 



The Computer . Be sure that you turn the 
computer on before you insert the CP/M 
diskette. 



The Diskettes . Any computer storage medium 
can be damaged, and your factory supplied 
CP/M System Diskette is no exception. 
Handle it carefully, holding it by the 
plastic jacket or the label* being sure 
not to touch the shiny surface of the 
recording media. Do not remove the 
adhesive wr i te-protect tab from the 
diskette. 



Insert the 
drive. Th 
ADVANTAGE 
ADVANTAGE 
drive 1 is 
its label i 
to the dirv 
After the d 
of the disk 



diskette in the appropriate floppy disk 
e correct procedure is described in the 
User Manual. If you have a standard 
with two floppy disk drives, floppy disk 
the upper drive. Hold the diskette so that 
s face up and its recording slot is nearest 
e. Slide the CP/M diskette into the drive, 
iskette clicks into place, close the latch 
drive. 



Press the RETURN key. 



ADVANTAGE 
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When the computer has loaded the program from the 
diskette into memory, the screen displays the message: 

64K Graphics CP/M 2.2 rev 1.0. n for ADVANTAGE AQ 
from North Star Computers, Inc. 

Slightly below it on the screen, the prompt appears: 

A> 

Before starting work with any new piece of software, 
you should duplicate the factory master diskette. The 
FORMAT program is the first step in this procedure, 
which consists of the following sequence of programs: 
FORMAT, CPMGEN, COLDBOOT, and PIP. 

2.2 FORMATTING A BLANK DISKETTE 

This stage of the start-up procedure requires you to 
format a blank diskette, so that it can store data 
properly. 

In response to the prompt, type FORMAT, then press the 
RETURN key. 

The screen responds with the following display : 

North Star Graphics CP/M 2.20 Diskette Formatter 
Initializes Diskettes for use with CP/M 

Select one of the format options below: 

D= Double-Density Single-Sided = D 
Q= Quad-Capacity (Double-Sided) = Q 
X= exit - Warm Boot from A: = X 

Enter option letter (D,Q,X): 

A quad capacity diskette provides twice the storage 
space available on a dual capacity diskette. To 
initialize a quad capacity diskette for the ADVANTAGE, 
type a Q and press RETURN. 

The display responds with the request: 

Enter Drive number (1-4) : 



The diskette you are to format should be inserted in 
the lower floppy disk drive, number 2. Type a 2, then 
press RETURN. 
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The display responds: 

Load Diskette in Drive: 2 

Strike RETURN <cr> when ready, 

To format as: Quad-Capacity Diskette 



Insert the blank diskette into the lower floppy disk 
drive, then close the latch on the drive and press 
RETURN. 

The display responds: 

- Proceeding to Format 70 * Tracks -... 

A row of asterisks appears across the screen as each 
track of the diskette is formatted. 

When the formatting is complete, the display reads: 

Diskette Successfully Initialized 

Select one of the format options below: ... 

Enter option letter (D,Q,X) : 



Type an X and press RETURN to finish this procedure. 
In response, the screen displays the CP/M prompt: 

A> 

The next step of the procedure is to tailor the CP/M 
diskette to the exact configuration of your hardware. 
The North Star version of the standard CP/M program 
MOVCPM.COM is called CPMGEN.COM. 



2.3 CPMGEN 



The CP/M Distribution Diskette is single-sided for 
maximum flexibility. This diskette should not be used 
except to generate a system diskette that takes full 
advantage of your hardware. The CPMGEN procedure is 
the next step toward producing a general purpose 
diskette. 
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With the factory supplied CP/M System Diskette in 
place in floppy disk drive 1, enter: 

CPMGEN 

and press RETURN. 

The CPMGEN program loads from the CP/M System Diskette 
into the memory, and the video screen displays the 
following prompt: 

North Star Graphics CP/M 2.2 System Generator. 

Note: All responses end with RETURN, 

- (minus sign) restarts at question 1, 
CONTROL-C aborts with warm boot. 



The series of questions listed below enables you to 
tailor the CP/M diskette to your hardware. After each 
answer, press RETURN. 

1. If you want to start the series of questions over 
again, type a minus sign (-) , then press RETURN. 

2. If you want to abort the entire procedure, press 
the CONTROL key and hold it down while pressing 
the letter C key. 



Ql. Enter Memory Size in Kilobytes OR 
Simply type RETURN for 64K? 



Pressing RETURN confirms the 64K value. If you wish, 
however, you may enter a number between 53 and 64, 
including fractions of .25, .5, or .75 to specify the 
size more precisely. 



Q2A. Enter Drive 1 Capacity (Q=Quad, RETURN=none) ? 



Specify the capacity of floppy disk drive 1. For the 
standard ADVANTAGE, type a Q, for quad capacity disk 
drive (double-sided, double-density) , then press 
RETURN. 
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Q3A. Enter Stepping Speed for Drive 1 
(F=Fast, N=NormaD? 



For the standard ADVANTAGE, type F, then press RETURN. 



Q2B. Enter Drive 2 Capacity 
(Q=Quad, RETURN=none)? 



For the standard ADVANTAGE, type Q, then press RETURN. 

Q3B. Enter Stepping Speed for Drive 2 
(F=Fast, N=Normal)? 



For the standard ADVANTAGE, type F, then press RETURN. 



Q2C. Enter Drive 3 Capacity 
(Q=Quad, RETURN=None)? 



The standard ADVANTAGE has two floppy disk drives, so 
for this basic configuration, press RETURN. 



Q4A. Is this a North Star HARD DISK System 
(Y or N)? 

For the standard ADVANTAGE, type N for No, then press 
RETURN. 



Q5. Do you want Read-Af ter-Write Check (Y or N)? 



If you enter a "Y", the system will verify the 
readability of all data written to a diskette. This 
read-af ter-write procedure extends run time, but is 
strongly recommended because it substantially 
increases system integrity. 



Q6. Enter Baud Rate of Serial Printer (9600 to 300) 
(for Parallel Printer, enter RETURN)? 



ADVANTAGE 2-5 . Graphics CP/M Preface 



For most serial RS232 printers, the Baud Rate is 1200, 
in which case you type the digits 1200, and press 
RETURN. The screen now displays the following prompt: 



Enter Destination Disk Drive number (1-4)- 
or RETURN to Cold-Boot from drive 1- 
or CONTROL-C to Warm-Boot? 



If you have a standard ADVANTAGE with two floppy disk 
drives, enter: 



to indicate that the Destination Disk Drive is to be 
the lower floppy disk drive, number 2. The program 
then prompts you to: 



Load output diskette in drive '2* 

and RETURN to write CP/M system onto it? 



If you skipped the FORMAT procedure described earlier, 
the screen will display a short line of characters and 
digits. Push the RESET button on the back of the 
ADVANTAGE. After the LOAD SYSTEM message appears, 
press RETURN, then follow the directions in Section 
2.2 above. 

If you followed the directions in Section 2.2, the 
program has copied the customized system tracks to the 
diskette, and the screen repeats the earlier message: 

Enter Destination Disk Drive number (1-4)- 
or RETURN to Cold-Boot from drive 1- 
or CONTROL-C to Warm-Boot? 



Enter a CONTROL-C to warm-boot the system. After a moment, 
the CP/M prompt reappears on the screen. 

A> 
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2.4 USING PIP FOR THE STANDARD ADVANTAGE WORKING COPY 

The diskette in the lower floppy disk drive now 
contains the customized CP/M tracks. To load the 
remaining files from the factory supplied system 
diskette onto the customized system diskette, use the 
program PIP, Enter: 

PIP B:=A:*.* 

and press RETURN, The floppy disk drive motors begin 
to whir and after a short pause, the screen displays 
the word: 

COPYING - 

followed by a list of files as each is copied, one by 
one, from the original CP/M system diskette to the 
system diskette you are generating. When the copying 
process is complete, the CP/M prompt reappears on the 
screen: 

A> 



2.5 COLDBOOT FOR THE STANDARD ADVANTAGE 

It is now necessary to cold-boot the system. Enter: 

COLDBOOT 

and press RETURN. After a moment the screen displays 
the message: 

LOAD SYSTEM DISKETTE AND RETURN TO COLD BOOT 



Remove the CP/M system diskette from the upper floppy 
disk drive. Store this diskette in a safe place. 

Remove the copy of the system diskette from the lower 
diskette and place it in the upper floppy disk drive. 
Close the floppy disk drive latch, and press RETURN. 

The ADVANTAGE reads the newly configured system tracks 
into memory, thereby completing the configuration 
process. Before beginning work with this newly 
configured system diskette you should copy it to 
create several backup versions. Then, if your system 
diskette is damaged by operator error, system failure 
or wear, other properly configured copies are 
available to replace it. 
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2.6 COPYING THE SYSTEM DISKETTE 

With the system diskette in the upper floppy disk 
drive, type COPY and press RETURN. 

The screen displays the messages: 

North Star Graphic CP/M 2.2 Diskette Copier (ver 1.1) 
Copies Double-Density or Quad-capacity Diskettes 

Mount the Diskettes to be processed and- 

Enter INPUT Drive number (1-4) : 

Or Mount System Diskette and RETURN to Exit: 

The INPUT drive is number 1, so type a 1. The screen 
displays the message: 

To Surface Check Only, Enter "N", 

To Verify-Compared two diskettes, Enter "V" 

To Copy, Enter OUTPUT Drive number (1-4) : 

The OUTPUT drive in this case is number 2, so place a 
blank quad-capacity diskette in the lower floppy disk 
drive. Then type a 2. The screen displays the message: 

Input is CP/M Quad-Capacity Diskette 
Enter RETURN for normal two-sided Copy: 



Press RETURN if the blank diskette is, as suggested, a 
quad-capacity diskette. The screen displays the 
messages : 



Proceeding to copy 70 track diskette 



The floppy disk drive motors whir for several seconds 
as the copying occurs, then the screen displays the 
message: 

Copy COMPLETE 



Mount the Diskettes to be processed and- 

Enter INPUT Drive number (1-4) : 

or Mount System Diskette and RETURN to Exit: 
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Since the COPY process is complete, press RETURN. The 
screen displays the CP/M prompt: 

A> 

Remove the newly created system diskette from the 
lower floppy disk drive and label it clearly. 

You can now proceed to make another copy of the system 
diskette. With several copies of the system diskette 
on hand, you can begin working with CP/M. The CP/M 
procedures are described in Sections 4 through 8 of 
this manual. 
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HARD DISK ADVANTAGE START-UP PROCEDURE 



This section details the start-up procedure for the 
ADVANTAGE with one floppy diskette drive and one hard 
disk drive. 



3.1 TEST AND FORMAT ADVANTAGE HARD DISK 

Turn on the ADVANTAGE by pressing the on/off switch on 
the back of the computer. A quiet "beep" sounds, the 
red light on the ALL CAPS key comes on, and the 



LOAD SYSTEM 

message appears, 
cursor. 



Beneath it, the screen displays a 



CAUTION 



Be sure that you turn the computer on 
before you insert the ADVANTAGE Hard 
Disk Supplement Diskette. 



Insert the ADVANTAGE Hard Disk Supplement Diskette and 
run Option 2, "COMPLETE HARD DISK TEST AND REFORMAT" 
according to the directions given in the ADVANTAGE 
HARD DISK SUPPLEMENT GUIDE. This option formats your 
hard disk and creates a GDOS SYSTEM account. 

This test goes through four passes of the PATTERN 
READ/WRITE TEST, and one each of the SERVO HARMONIC 
TEST and the SERVO RANDOM TEST. The complete test 
sequence takes about 50 minutes to run. 

When the test is completed, reset the ADVANTAGE to 
begin configuring the CP/M System Diskette by 
entering: 



the RESET SYSTEM option on the main ADVANTAGE HARD 
DISK SUPPLEMENT menu. Now, press RETURN. 

You again receive the message: 

LOAD SYSTEM 



ADVANTAGE 
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Remove the ADVANTAGE HARD DISK SUPPLEMENT DISKETTE 
from floppy disk drive 1 and insert the factory 
supplied Graphics CP/M System Diskette. You are now 
ready to create a copy of the system diskette for 
your own day to day use. 



CAUTION 


Any compi 


iter 


storage med 


ium 


can 


be 


damaged, 


and 


your Graphics 


CP/M System 


Diskette 


is 


no exception. 


Handle 


it 


carefully 


, h 


olding it by 


the 


plastic 


jacket or 


the 


label, and mak 


ing 


sure 


not 


to touch 


th 


e shiny surf 


ace 


of 


the 


recording 


me 


dia. Do not 


remove 


the 


adhesive 


wr i te-protect tab f 


rom 


the 


diskette. 













Insert the diskette into floppy disk drive 1. Hold 
the diskette so that the label is face up andits 
recording slot is nearest to the drive. Slide the 
diskette into the drive. After the diskette clicks 
into place, close the latch on the disk drive. 

Press the RETURN key. 

When the computer has loaded the program from the 
diskette into memory, the screen displays the message: 

64K Graphics CP/M 2.2 rev 1.0. n for ADVANTAGE AQ 
from North Star Computers, Inc. 

Slightly below it on the screen, the CP/M prompt 
appears: 

A> 

Before starting work with any new piece of factory 
supplied software, you should duplicate the factory 
master diskette. The FORMAT program is the first step 
in this procedure, which consists of the following 
sequence of programs: FORMAT, CPMGEN, ONECOPY, and 
COLDBOOT. 



ADVANTAGE 
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3.2 FORMATTING A BLANK DISKETTE 

This stage of the start-up procedure requires you to 
format a blank diskette, so that it can store data 
properly. 

In response to the CP/M prompt, type FORMAT, then 
press the RETURN key. 



The screen responds with the following display: 



North Star Graphics CP/M 2.20 Diskette Formatter 
Initializes Diskettes for use with CP/M 

Select one of the format options below: 

D= Double-Density Single-Sided = D 
Q= Quad-Capacity (Double-Sided) = Q 
X= exit - Warm Boot from A: = X 

Enter option letter (D,Q,X) : 



To initialize a quad capacity diskette for the 
ADVANTAGE, type a Q and press RETURN. 

The display responds with the request: 

Enter Drive number (1-4) : 

Enter the number 1. 
The display responds: 



Load Diskette in Drive: 1 

Strike RETURN <cr> when ready, 

To format as: Quad-Capacity Diskette: 



Remove the CP/M System diskette from floppy disk drive 
1, replace it with the blank diskette. Close the 
latch on the drive, and press RETURN. 
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The display responds: 

- Proceeding to Format 70 * Tracks -... 

A row of asterisks appears across the screen as each 
track of the diskette is formatted. 

When the formatting is complete, the display reads: 

Diskette Successfully Initialized 

Select one of the format options below: ... 
Enter option letter (D,Q,X) : 

Remove the formatted blank diskette from floppy disk 
drive 1 and replace it with the factory supplied CP/M 
System Diskette. 

Type an X and press RETURN to finish this procedure. 
In response, the screen displays the CP/M prompt: 

A> 

The next step of the procedure is to tailor the CP/M 
diskette to the exact configuration of your hardware. 
The North Star version of the standard CP/M program 
MOVCPM.COM is called CPMGEN.COM. 



3 . 3 CPMGEN 



The Graphics CP/M System Diskette is double-sided for 
maximum flexibility. The factory supplied CP/M System 
Diskette should only be used to generate a copy of 
CP/M that takes full advantage of your hardware. The 
CPMGEN procedure is the next step toward producing 
your general purpose system diskette. 

With the factory supplied diskette secured in the 
floppy disk drive, . enter: 

CPMGEN 

and press RETURN. 

The CPMGEN program loads from the System Diskette into 
the memory, and the video screen displays the 
following messages: 
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North Star Graphics CP/M 2.2 System Generator. 

Note: All responses end with RETURN, 

- (minus sign) restarts at question l f 
CONTROL-C aborts with warm boot. 

The series of questions listed below enables you to 
tailor the CP/M diskette to your hardware. After each 
answer, press RETURN. 

1. If you want to start the series of questions over 
again, enter a minus sign (-) and press RETURN. 

2. If you want to abort the entire procedure, press 
the CONTROL key and hold it down while pressing 
the letter C key. 



Ql. Enter Memory Size in Kilobytes OR 
Simply type RETURN for 64K? 



Pressing RETURN confirms the 64K value. If you wish, 
however, you may enter a number between 53 and 64, 
including fractions of .25, .5, or .75 to specify the 
size more precisely. 



Q2A. Enter Drive 1 Capacity (Q=Quad, RETURN=none) ? 

Specify the capacity of floppy disk drive 1. Enter: 

Q 

for quad capacity disk drive (double-sided, double- 
density), then press RETURN. 

Q3A. Enter Stepping Speed for Drive 1 
(F=Fast, N=NormaD? 

Enter: 

then press RETURN. 

Q2B. Enter Drive 2 Capacity (Q=Quad, RETURN=none) ? 

Since you have already configured your floppydisk, 
press RETURN. 
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Q4A. Is this a North Star HARD DISK System 
(Y or N)? 

Enter: 

Y 

to answer YES to the prompt and press RETURN. You 
will receive the following question, 

Q4B. Give the PATHNAME of the HARD DISK Work File 
OR Simply type RETURN for "CPMWORK"? 

Press RETURN for the default PATHNAME, "CPMWORK" or 
enter a new name. 

For further information, see the discussion on CP/M 
workfiles and hard disk account names in Section 9.3. 

Q5. Do you want Read-Af ter-Write Check (Y or N)? 

Entering a "Y" will cause the system to verify the 
readability of all data written to a diskette. This 
read-af ter-write procedure extends run time, but is 
strongly recommended since it substantially increases 
system integrity. 

Q6. Enter Baud Rate of Serial Printer (9600 to 300) 
(for Parallel Printer, enter RETURN)? 

For most serial RS232 printers, the Baud Rate is 1200, 
in which case you enter the digits: 

1200 

and press RETURN. 

The screen now displays the following prompt: 



Enter Destination Disk Drive number (1-4)- 
or RETURN to Cold-Boot from drive 1- 
or CONTROL-C to Warm-Boot? 

Enter: 

1 

to indicate that the Destination Disk Drive is to be 
the lower drive, floppy disk drive number 1. 
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The program then prompts: 

Load output diskette in drive 1 

and RETURN to write CP/M system onto it? 



If by chance you skipped the FORMAT procedure 
described earlier in this section, the screen will 
display a short line of characters and digits. Push 
the RESET button on the back of the ADVANTAGE. After 
the message: 

LOAD SYSTEM 

appears, press RETURN, then follow the directions in 
Section 3.2 above. 

If you followed the directions in Section 3.2, the 
program writes the customized system tracks onto the 
diskette and the screen repeats the earlier message: 

Enter Destination Disk Drive number (1-4)- 
or RETURN to Cold-Boot from drive 1- 
or CONTROL-C to Warm-Boot? 



Press RETURN. 

The ADVANTAGE prompts: 

LOAD SYSTEM 

Press RETURN again. 

CP/M will boot-up with its hard disk herald, then 
prompt: 

HDBOOT? 
A> 
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3.4 COPY THE CP/M SYSTEM DISKETTE WITH ONECOPY 

The diskette in floppy disk drive 1 now contains the 
customized CP/M system tracks. To load the remaining 
CP/M utility files from the factory supplied CP/M 
System Diskette onto your customized copy, use the 
ONECOPY program. 

Enter: 

B:ONECOPY *.*<CR> 
The console displays: 

MOUNT B: IN DRIVE 1, TYPE ANY KEY 

Remove the customized diskette from floppy disk drive 
1. Insert the factory supplied CP/M system diskette 
into floppy disk drive 1 and press any key - the space 
bar will do. 

The console displays: 

Mount INPUT Diskette and type RETURN 

The programs you want to copy are on the CP/M System 
Diskette in floppy disk drive 1, so press RETURN. 

ONECOPY requests: 

MOUNT A: IN DRIVE 1, TYPE ANY KEY 

Leave the System Diskette in floppy disk drive 1 and 
press any key. 

ONECOPY prompts: 

Mount OUTPUT Diskette and type RETURN 

Insert the customized copy of the distribution 
diskette into floppy disk drive 1 and press RETURN. 

ONECOPY begins to copy the programs from the North 
Star CP/M System Diskette to your customized copy. 
***** There are several requests for diskette changes. 
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When ONECOPY is completed, the program will prompt: 
Mount System Diskette, type RETURN to Warmboot 

Leave your working copy in drive 1 and press RETURN. 

When you receive the CP/M prompt enter: 
COLDBOOT 

and press RETURN for a normal hard disk startup. 

At this point you can make another copy of your 
customized system diskette, using SYSGEN and ONECOPY. 
This precaution is advisable, since it protects you 
from program loss due to operator error, equipment 
malfunction, and diskette wear. 

3.5 ESTABLISHING HARD DISK GDOS FILES FOR CP/M USE 




image of a diskette on the hard disk complete with 
file directory . Using GDOS commands, the logical 
drive can be set to varying sizes to provide maximum 
flexibility for your CP/M applications and data. For 
a discussion of the considerations that might make 
various choices of logical drive length and CP/M 
allocation block size preferable, see Section 9.4. 

Make sure that you have formatted the hard disk 
according to the procedures outlined in Sections 3.1 
through 3.4 before inserting your floppy disk. 

Insert a working copy of the CP/M System Diskette into 
the floppy disk drive. 

Press the RETURN key to boot-up CP/M. 
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For purposes of illustration, this example will create 
two CP/M hard disk units and connect them to logical 
drives A and B. The following GDOS commands will 
create two CP/M logical drives of substantially 
different sizes. These choices permit it considerable 
expansion at a later time. See Sections 9.4.2 and 
9.4.3 for a discussion of the procedures and 
constraints governing expansion of existing units and 
the use of application programs on the units. 

1. To create a file for CP/M logical drive A with a 
total storage capacity of 500 Kilobytes, specify 
2056 GDOS file blocks. Each GDOS file block 
contains 256 bytes. To store the data in CP/M 
blocks of 2 Kilobytes each, specify an allocation 
factor of 2. The GDOS command is: 

=CR CPMUNITA 2056 2 

2. To create a file for CP/M logical drive B, with a 
total capacity of 1 Megabyte, specify 4112 GDOS 
file blocks. To store the data in CP/M blocks of 
4 Kilobytes, specify an allocation factor of 4. 
The GDOS command is: 

=CR CPMUNITB 4112 4 

To return to CP/M, enter: 



=CP <CR> 



The next step is to establish the connection between 
the GDOS files or "pathnames" you have just created, 
and the CP/M logical drives, or "units" they will 
match. 



The HDBOOT program will automatically output the 
following message on the terminal: 

CONNECTIONS IN WORK FILE: CPMWORK 

ENTER A CONNECTION or T=To HDOS or S=SAVE or X=EXIT? 



The work file name that appears will be CPMWORK if you 
accepted this default value in the CPMGEN procedure. 
If you supplied another name, it will appear instead. 
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The format for entering the connection is 
straightforward. 

Unitletter :Pathname 

The first connection is: 

A:CPMUNITA 

After you have supplied this information the program 
will review the table you are beginning to build, and 
ask for further input. 

Proceed to connect the other GDOS file you have 
established to the appropriate CP/M logical drives, as 
follows: 

B:CPMUNITB 

After each connection you enter, the program will 
repeat its summary of connections, and request further 
input. 

The preceding steps allow CP/M to store and access 
data on the hard disk. To incorporate diskettes into 
this structure, you must also establish a connection 
to the floppy disk drive in your system. 

The format for such a connection is slightly 
different. Enter: 

Unitletter :, Drive Number 

Each CP/M system diskette can handle up to sixteen 
logical drives at any time, so the unit letters can 
range from A to P. To access the floppy disk drive, 
you might assign the unit letter M. 

Enter the command: 

M:,l 

The table of connections should now read: 

CONNECTIONS IN WORK FILE: CPMWORK 

A:CPMUNITA 
B:CPMUNITB 
M:,l 

ENTER A CONNECTION OR T=To HDOS or S=SAVE or X=EXIT? 
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Enter an S to save the list of connections you have 
built. 

The program now asks whether you want to review this 
list of connections every time you cold-boot CP/M from 
a diskette that references the CPMWORK as the work 
file. 

ENTER "N" TO MAKE FUTURE BOOTSTRAPS NON-STOP 
ENTER "B" TO REVIEW CONNECTIONS EVERY COLD BOOT 

If you choose B, the next time you cold-boot CP/M, it 
will display the table of connections for you to 
review and change if you wish. 

If you choose N, the table that you have just created 
will be used automatically on future cold-boots. For 
now, type B to allow you to review the connection 
table on cold-boot. 

For further information, you should read the 
discussion on altering the connection table in section 
9.2.2 below. 

After you enter your response, the computer will write 
the connection table onto the CP/M hard disk work-file-- 
for future bootstraps. In addition, the CP/M system 
diskette in drive 1 is accessed, and the CP/M system 
is copied onto the workfile, so that subsequent warm 
boots can be made directly from the hard disk. 



NOTE 



Whenever you cold-boot the system, 
your CP/M system diskette must be 
present in the floppy disk drive. 



Copy all the files from your working CP/M system 
diskette onto the hard disk. (Remember that the system 
diskette is now designated as unit M). The unit on the 
hard disk you are copying onto is unit A. The command 
you give is: 

M:PIP A:=M;*.* 
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Exercise the system with the STAT.COM file to see how 
much space is available in each logical drive. Give 
the command: 

A>STAT A:DSK: 
A>STAT B:DSK: 
A>STAT C:DSK: 

You can now remove the CP/M system diskette from 
floppy disk drive 1. You will need to insert it 
again, the next time you want to cold-boot CP/M onto 
the hard disk or run HDBOOT directly, so keep the 
diskette available. 



3.6 SHUTTING DOWN THE HARD DISK 

Whenever you are going to shut down the hard disk, run 
the program HD0FF.COM to ensure that the Hard Disk 
read/write heads are retracted to their special 
landing zones on the disk. This precaution is 
essential if you are going to physically move the 
ADVANTAGE, since data may be lost if the read/write 
heads land on a data sector. 

Enter: 

HDOFF 
The program will prompt with the message: 

LOAD SYSTEM DISKETTE AND RETURN TO COLD BOOT 

The hard disk read/write heads have been reset at this 
point. You can either load another system diskette 
and continue processing or turn off the ADVANTAGE and 
move it safely. 
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USING CP/M ON THE ADVANTAGE 



4.1 STARTING UP A WORK SESSION WITH CP/M 



First, turn the ADVANTAGE on by pressing the on/off 
switch on the back of the computer. A "beep" sounds, 
the red light on the ALL CAPS key comes on, and the 
message: 

LOAD SYSTEM 

and a cursor appear on the screen. 

Next, insert a working copy of the CP/M system 
diskette in floppy disk drive 1. Close the drive 
latch, and press the RETURN key. 

The portion of CP/M that must always be resident in 
the internal memory, the "system tracks," is now read 
off the diskette and into the memory. When this 
process is complete, the CP/M herald appears on your 
screen: 

64K Graphics CP/M vers 2.2 rev A for Advantage Ax 
from North Star Computers, Inc. 

Note that the "x" in the herald will be replaced by a 
"Q" if you have configured a standard ADVANTAGE with 
two floppy disk drives, or by an "H" if you have 
configured a hard disk ADVANTAGE. 

The CP/M system herald is followed by the CP/M prompt: 

A> 

You can now use any of the system routines that are 
part of the CP/M Console Command Processor (CCP). 
These built-in commands, DIR, TYPE, REN, and ERA, are 
described in more detail in Section 5.2. 



4.2 RUNNING UTILITY OR APPLICATION PROGRAMS 

The CP/M diskette includes a number of utility 
programs as well as the system routines. The utility 
programs are described in Sections 5.4 - 5.5 of the 
next chapter. The special enhancements that North Star 
CP/M includes are described in Section 6. 



ADVANTAGE 4-1 Graphics CP/M Preface 



CP/M also allows you to run a wide range of 
application programs. Consult the appropriate manual 
for the application program you want to use for 
instructions on the correct procedures. 



4.3 FLOPPY AND HARD DISK DRIVES 

As the start-up procedure indicates, several CP/M 
programs (COPY, FORMAT, CPMGEN, AND SYSGEN) , use 
numbers to designate disk drives. All other CP/M 
programs (including ONECOPY) use letters to designate 
disk drives. The upper floppy disk drive on the 
standard ADVANTAGE is referred to either as drive A, 
or 1; the lower floppy disk drive is either drive B, 
or 2. 

With the hard disk ADVANTAGE, the lower floppy disk 
drive is always the number 1 for these CP/M programs. 
See Section 9 for a discussion of CP/M logical drive 
names on the hard disk. 

The CP/M system prompt tells you into which drive you 
are logged. The prompt: 

A> 

means that you are logged onto drive A. If you want to 
log onto drive B, you enter: 

B: 
then press RETURN. The system prompt responds with: 

B> 

This shows that you are now logged onto drive B. 

To use a file on the drive you are currently logged 
onto, you don't need to specify the drive. If you want 
to use a file from a different drive, however, you 
must stipulate the drive so CP/M will know where to 
look for it. 

For example, if you are in drive B, and you want to 
edit a file named MEMO. TXT on drive B, but the editor 
program is on drive A, the complete command would 
read: 

B>A:ED MEMO. TXT 
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4.4 CHANGING PROGRAMS OR DISKETTES 

When you want to change from one CP/M utility program 
to another, or from one application program to 
another, press CONTROL-C. This produces a "warm boot", 
which transfers control of the computer back to the 
Console Command Processor of CP/M. After a warm boot, 
you can direct CP/M to retrieve another program from 
diskette or hard disk, bring the program into memory, 
and shift control of the ADVANTAGE to that program. 

Likewise, if you want to insert a different diskette 
into a floppy disk drive, you must enter a CONTROL-C 
before trying to read from or write into the new ...x 
Warm-boot, reset disk subsystems diskette. The warm- 
boot causes CP/M to reset the disk subsystems in the 
computer, and alerts the computer to the presence of a 
new diskette. 

If you want to use a blank diskette in an ADVANTAGE, 
you must initialize the diskette with the FORMAT 
program before you can store data on it. The standard 
ADVANTAGE program, COPY, is the only exception to this 
requirement. 

You can use the COPY program to transfer data to a 
blank diskette without having to format the diskette 
first. This is possible because the COPY program 
copies the formatting from the original diskette, 
along with the data. 

The ONECOPY program used with the hard disk ADVANTAGE 
uses PIP style copying, and so requires blank 
diskettes that have been formatted with the FORMAT 
program. 



4.5 CHANGING OPERATING SYSTEMS 

The North Star version of CP/M includes a special 
program for cold-booting the system. When you have 
finished working with CP/M and want to shift to 
another operating system, the first step is to enter a 
CONTROL-C to produce a warm-boot. 

. This procedure transfers control of the computer back 
to the Console Command Processor (CCP) , and logs you 
back into the same drive. 
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Then, in response to the system prompt type ArCOLDBOOT 
and press the RETURN key. The screen displays the 
message: 

LOAD SYSTEM DISKETTE AND RETURN TO COLD BOOT 

When you have ensured that a CP/M system diskette is 
present in the appropriate floppy disk drive/ press 
the RETURN key to initiate the COLDBOOT program. 
Almost instantly the screen displays the ADVANTAGE 
prompt: 

LOAD SYSTEM 

This procedure brings your work in CP/M to an orderly 
termination. You can now remove the CP/M diskette(s) 
from the ADVANTAGE. 

Insert the new system diskette you want to work with 
in floppy disk drive 1, close the disk latch, and 
press RETURN. 



4.6 DISKETTE CAPACITY 

Quad capacity CP/M diskettes have a capacity of 64 
directory entries. 

For a quad diskette, (i.e, double-sided, double- 
density) the file storage area is 338K; for a dual 
diskette (single-sided, double-density) the file 
storage area is 163K. 

All diskettes used on the ADVANTAGE must be double- 
density. 



4.7 FILE NAMES 

A typical CP/M file name, such as INTRO.TXT consists 
of two separate elements. The primary name, "INTRO" in 
this case, can contain up to eight characters. The 
extension, here "TXT", can contain a maximum of three 
characters. The primary name and the extension are 
always separated by a period. Both the primary name 
and the extension can contain any characters except 
<>,.:=*?[]. 
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The extension specifies the nature of the file. 
Programs that can be executed, such as the CP/M 
utility files, have the extension COM and are 
therefore known as .COM files. Files containing 
assembly language source code have a .ASM extension. 
Extensions are required for certain kinds of files 
such as .COM, .ASM, .HEX, but are optional in other 
cases. You can make up your own extensions, such as 
.TXT, for text tiles, or .WRK for working files. 

The characters * and ? allow you to specify multiple 
rather than individual files. That is, ? matches any 
character in the corresponding position. * matches any 
and all characters on that side of the period. For 
example, 

INTR7.TXT matches INTRO.TXT and INTRA. TXT 

*.ASM matches DUMP.ASM and USER.ASM 

DUMP.* matches DUMP.ASM and DUMP.COM 

*.* matches all file names. 

For example, the command: 

PIP A:=B:*.* 

will copy all files from one disk drive or unit to 
another, without having to specify each file name 
individually. 



CAUTION 



Since the command ERA *.* erases all 
files on the CP/M logged disk drive, 
you should be absolutely sure that 
this is what you really want to 
accomplish before rather than after 
you enter the command. 



ADVANTAGE 



4-5 



Graphics CP/M Preface 



ADVANTAGE 4-6 Graphics CP/M Preface 



STANDARD CP/M CAPABILITIES 



5.1 INTRODUCTION 

Much of the information you need to use CP/M 
effectively is contained in the Digital Research 
manuals in this binder. The following section 
provides a quick overview of CP/M that may help orient 
you as you start to use this operating system. 



5.2 SYSTEM ROUTINES 

CP/M's Console Command Processor contains several 
intrinsic, or built-in commands that perform certain 
crucial functions. The most useful of these are 
described below. 

5.2.1 DIR 

This command produces a list of all the files stored 
on a given diskette or hard disk unit. The format for 
the command is: 

A>DIR 

You do not need to designate the drive if you want to 
list all the files on the diskette or hard disk unit 
in the drive into which you are logged. If you want to 
see the directory for a different diskette or unit, 
you must specify the appropriate drive. For example: 

A>DIR B: 

The directory does not list the system commands 
described in this section, only the names of the 
programs and files stored on the diskette in question. 
The STAT.COM program, described below in Section 
5.4.1, furnishes a much more informative listing of 
the files, including space accounting. 
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5.2.2 TYPE 



This command is useful for quickly reviewing a text 
file that you have just created or revised. For 
example, to display the contents of a file 
ORIGINAL.TXT after you have finished editing it, type: 

A>TYPE ORIGINAL.TXT 

If you were logged onto drive A at the time, and 
wanted to scan the contents of this file on drive B 
you would give the command: 

A>TYPE B:ORIGINAL.TXT 

This command can be used to print a file, as well as 
display it. To print a file, enter the type command, 
tnen press the CONTROL key and hold it down while 
pressing the P key. Then press RETURN. 



5.2.3 REN 



This command allows you to rename a file on a given 
diskette. The format for this command is: 

REN new=old 

For example, once you finished modifying the content 
of a file called ORIGINAL.TXT you might wish to change 
the name to REVISED.TXT and leave it stored on the 
same drive, A. If so, you would type: 

A>REN REVISED.TXT=ORIGINAL.TXT 

CP/M then discards the old name and stores the file 
under the new name you have specified. 
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5.2.4 ERA 

This command allows you to erase a file. The format 
is: 

ERA filename 

This command should be used with great discretion, 
since it leads to file erasure. For example, to erase 
the file named REVISED.TXT on drive A f when you are 
logged onto drive A, you would enter: 

ERA REVISED.TXT 

You can use the wild cards * and ? with this command 
to specify a range of files. For example, to erase all 
the .PRN files that an assembler has generated from 
the diskette in drive A, when you are logged into 
drive A, the sequence is: 

ERA *.PRN 

5.3 CONTROL CHARACTERS 

CP/M uses control characters to perform certain basic 
functions. Some of the most common control characters 
are listed below. See Section 6.2 for a description of 
other control characters that are operative under the 
***** character I/O sub-system of CP/M. To enter a control 
character, you should hold down the CONTROL key as you 
would a shift key, then press the specified letter 
key. 



BACKSPACE 

The backspace key functions as a destructive 
backspace. This North Star version of CP/M also 
contains a backspace using the F15 key. This key 
reverse-echoes the character to the console as it 
erases. 
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CONTROL-X 

***** Erases the current line, and moves the cursor back to 
the beginning of that line. 

CONTROL-C (only at the beginning of a line) 

Transfers control back to the Console Command 
Processor portion of CP/M. This combination of keys 
often aborts whatever program might be under way, and 
may even destroy data. This command causes the 
operating system to do a warm boot, so it is needed 
after every change of diskettes. 

RETURN 

Enters the line just completed, or executes the 
current command. 

CONTROL-S 

***** Halts or suspends a console output display to permit 
closer scrutiny. Indeed any key except CONTROL-C 
restarts the display. 

CONTROL-P 

Toggles the printer on and off, starting and stopping 
printer output. CONTROL-P printing is cancelled with a 
warm boot. 



5.4 UTILITY PROGRAMS 

The utility programs listed in the directory provide a 
wide range of capabilities for transferring, editing, 
debugging programs, and so forth. 

In general, the most valuable CP/M utility programs 
are STAT.COM and PIP.COM. 
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5.4.1 STAT 

STAT Is the file status program. It lists all utility 
***** programs on a diskette or hard disk CP/M unit 
alphabetically, displays their status, and computes 
their size. This listing displays the number of 
records in each file, the number of bytes allocated to 
each file, and the number of physical extents 
consumed. On a quad diskette, an extent equals 256 
records and each record equals 128 bytes. At the end 
of the listing the remaining available disk space is 
indicated. 

To examine the contents of a CP/M diskette (not 
including the built-in system routines described in 
Chapter 4) give the command: 

A>STAT *.* 

The following table gives a portion of a sample 
STAT.COM listing. 

Recs Bytes Ext Ace 

1 R/W A: ASM. COM 

1 R/W ArC0PY.COM 

1 R/W A: CPMGEN.COM 

1 R/W A: DDT. COM 



1. To find the number of bytes remaining on a 
diskette in another drive, such as drive B when you 
are logged onto drive A, give the command: 

A>STAT B: 



2. To change the status of a single file on a 
diskette, give the command: 

STAT filename $R/W 
STAT filename $R/0 

For example, to change the status of ED.COM to 
Read/Only, when you are logged onto drive B, and 
the program is on A, give the command: 

B>STAT A: ED. COM $R/0 



64 


8K 


17 


3K 


114 


16K 


38 


6K 
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3. To set all files on a disk to Read/Only status, 
give the command: 

A>STAT B:*.* $R/0. 

You may wish to set the customized CP/M system 
diskette to Read/Only status, to prevent 
***** accidental erasures. Read/Only files can be 
neither ERAsed, RENamed, nor EDitedl 

You may also want to prevent certain files from 
appearing on your directory. For example if you 
have STAT.COM on every diskette, you may not want 
to see it listed in the directory. The command: 

A>STAT STAT.COM $SYS 

causes STAT.COM to assume system status and behave 
like DIR, ERA, and other system commands. However, 
STAT.COM would always be listed in response to the 
command: 

A>STAT *.* 



5.4.2 PIP 

The Peripheral Interchange Program allows you to 
transfer data between I/O devices. It is primarily 
***** use< 3 to copy files between diskettes or between hard 
disk CP/M units. 

There are two ways to execute PIP.COM. One is to 
respond to the system prompt by calling the PIP 
program into memory. 

Give the command: 

A>PIP 

The screen then displays the PIP prompt, an asterisk 
(*). This is the method used in examples 1 and 2, 
below. Alternatively, you can use a one-line version 
of this commmand, as shown in examples 3 and 4 below. 
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1. To copy a file from one disk into another, respond 
to the prompt * by giving a command that follows 
the general format: 

* D:=S:FILENAME 

The character s represents the source, or input 
drive and represents the destination, or output 
drive. For example, to copy a file called 
WORKING.TXT from A to B, give the command: 

*B : =A: WORKING. TXT 



2. To copy a file from one drive to another under a 
different name, follow the format: 

*D:COPY=S: ORIGINAL 

For example, if you are logged onto drive B, and 
want to copy WORKING.TXT from drive B to drive A, 
while renaming it as FINISHED.TXT, give the 
command : 

*A:FINISHED.TXT=B:WORKING.TXT 

That single line equals the series of commands: 

A>PIP A:=B:WORKING.TXT 

A>REN A:FINISHED.TXT=A: WORKING. TXT 

3. File matches can be used to copy multiple files. 
For example, File A.TXT, File B.TXT, and File 
C.TXT can all be copied from drive A to drive B 
with the following single line command: 

A>PIP B:=A:*.TXT 

4. PIP will copy all files on a disk, using a single 
file match. It is important to note, however, that 
PIP cannot copy the system area of the CP/M 
diskette. Use SYSGEN.COM for that purpose. 

To copy all files from drive A to drive B, give 
the command: 

A>PIP B:=A:*.* 

PIP can also be used to copy a portion of a file, 
or to transfer a file that is stored on a disk to 
the printer. Consult the Digital Research manual 
on the PIP program for further details. 
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To copy a file named DUMP.PRN to the printer, give 
the command: 

A> PIP LST: = DUMP.PRN [T8P60] 

The [T8] expands tabs to every eighth column. Many 
printers require a generalized tab specification, 
which the TX option provides. The [P60] causes the 
printer to begin a new page after every 60 printed 
lines. 



5.5 OTHER .COM FILES' 

5.5.1 SYSGEN 

SYSGEN.COM moves the CP/M system between memory and 
the system tracks of a diskette. SYSGEN copies only 
***** the CP/M system, not data files or programs like 
STAT.COM that are listed in the directory. SYSGEN is 
the complement of PIP, since PIP only copies data 
files or programs. SYSGEN is also used (with DDT) to 
copy the CP/M system into memory at an address 
convenient for patching. 

5.5.2 DDT 

The DDT.COM program is a "Dynamic Debugging Tool." It 
can debug a .HEX file or a .COM file, and can be used 
to patch any file. 

5.5.3 SUBMIT 

SUBMIT.COM provides command batching facilities. 

5.5.4 DUMP 

The DUMP.COM program displays the contents of any file 
in hexadecimal form. The DUMP. ASM file is the source 
code for DUMP.COM, provided by Digital Research as a 
sample CP/M assembly language program. 

5.5.5 ED 

The ED.COM program is useful for text editing, 
particularly if you don't have other editing or word 
processing software. 

5.5.6 ASM 

The ASM.COM program translates a source file written 
in assembly language into a .HEX file. 
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5.5.7 LOAD 



The LOAD.COM program turns a .HEX file (produced by 
ASM from a .ASM file) into an executable program, 
i.e., a .COM file. 



***** 

5.6 ERASING UNNEEDED FILES PROM WORKING COPIES OF THE CP/M 
DISKETTE 

Never erase anything from the original CP/M 
***** system diskette. In fact, do not even remove the 
write-protect tab from the system diskette. This 
precaution will ensure that all of the capabilities of 
the operating system remain available to you, even 
though some may now be irrelevant. 

You may, however, find it advantageous to erase 
certain utility programs from copies of your working 
system diskettes to increase the storage space 
available for other programs and data. 

THE PIP.COM and STAT.COM programs are very practical 
and should almost always be retained. 

***** However, Software development files, such as DUMP.ASM 
and DUMP.COM, may be eliminated if you are not putting 
CP/M to work in this fashion. It is possible to cut 
the storage space CP/M requires to about 40K, while 
retaining a very desirable set of capabilities. 

You may find that what serves your purposes best is to 
use SYSGEN to copy the system area of CP/M onto a 
formatted diskette, then copy PIP and STAT onto the 
same diskette and use the rest of the space on the 
diskette for storing programs and data files. 
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NORTH STAR ENHANCEMENTS TO CP/M 



6.1 NORTH STAR UTILITY PROGRAMS 

North Star has added or enhanced several programs of 
CP/M.. Some of these programs have already been 
introduced in the Start-Up section. These programs 
are summarized below: 

1. CPMGEN.COM replaces the Digital Research program 
M0VCPM.COM. This program reconfigures CP/M to the 
exact memory and hardware in use, then writes this 
inf ormationonto the "system tracks" of the 
diskette. 

2. C0PY.COM lets you copy the contents of an entire 
diskette onto a blank diskette in another floppy 
disk drive. It does not allow you to copy 
selectively. PIP.COM, described in section 4.4.2, 
provides this option. 

COPY also enables you to surface check a diskette 
after a non-recoverable error. 

If you are using the hard disk ADVANTAGE, with 
only a single floppy disk drive, you must use the 
ONECOPY program to copy information from one 
diskette to another. However, you can still use 
the surface check option of the COPY program to 
check a diskette after a non-recoverable error. 

3. 0NEC0PY.COM provides you with a means of copying 
any number of files from one diskette to another 
using only one floppy disk drive. 

4. F0RMAT.COM allows you to format a blank diskette 
properly for CP/M use. 

5. L0CAL.COM provides a way to send control 
characters directly to the CRT display. This 
program is useful for turning on smooth scrolling, 
for example. 

6. C0LDB00T.COM provides a way to reboot the system 
from the keyboard. 

7. GMGRADD.COM is a program in which the graphics 
manager has been embedded. This program links the 
graphics manager to a program that has been 
written to use these graphics capabilities. 
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8. CONTROL T invokes the NS100 screen dump program. 
This program dumps the contents of the ADVANTAGE 
Video display to the NS100 printer on a pixel by 
pixel basis. 

9. GDDT.COM provides a convenient way to debug 
graphics programs. 

10. DIRDUMP.COM dumps the CP/M directory and 
translates CP/M block number and DOS sector number 
to facilitate error analysis and recovery. 

11. SYSGEN.COM moves the CP/M system between memory 
and the system tracks of a diskette. SYSGEN only 
copies the CP/M system, not utility programs like 
STAT.COM that are listed in the directory. SYSGEN 
therefore, is the complement of PIP which only 
copies utility programs and never addresses the 
CP/M system. SYSGEN is also used (with DDT) to 
copy the CP/M system into memory, at an address 
convenient for patching. 

***** 12. USER.ASM contains the assembly source code of the 
User Area that North Star incorporates into this 
version of CP/M. This includes the code for 
controlling the sequential I/O devices such as a 
printer, a punch, and a reader. All console I/O 
passses through the user area, so that special 
filtering can be done. 

To enable North Star CP/M to work with non- 
standard peripherals, you must rewrite the 
USER.ASM file to include your modified I/O 
drivers, reassemble the code, and use SYSGEN and 
DDT to overlay the I/O area in an image of CP/M. 
See Section 8 for further details. 



ADVANTAGE 6-2 Graphics CP/M Preface 



6.2 CHARACTER I/O SUBSYSTEM 
6.2.1 Introduction 



The ADVANTAGE screen can display both characters and 
graphic images. Some of these functions are performed 
by the character I/O subsystem; others are performed 
by the graphics subsystem. 

Character output to the console evokes the character 
I/O subsystem. This allows you to manipulate the 
display in a variety of ways. 

When the output consists of printable characters, 
either alphanumerics or special symbols, the video 
subsystem displays them on the screen. The location 
of each character is determined by a cursor. The 
characters are positioned within a grid that is 80 
characters wide and 24 lines deep. 

When you enter certain control codes or escape 
sequences, the display is altered accordingly: 

•the screen is turned on or off, 
•the screen is cleared wholly or partially, 
•the cursor is moved or turned on or off, 
•smooth scrolling is turned on or off, 
•the speed of smooth scrolling is changed, 
•auto-wraparound is turned on or off, or 
• reverse video is turned on or off. 

Other codes cause the audio tone to sound, and turn on 
or off audio feedback for characters typed at the 
keyboard. A further pair of codes masks or unmasks 
bit 7, on character codes typed on the keyboard. 
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6.2.2 Details on Character I/O Subsystem 



The character I/O subsystem functions detailed in 
***** Table 6-1 can be incorporated into user progams by 
invoking the appropriate character output. 
Additionally, the CP/M LOCAL program allows you to 
output control characters to the console or printer. 

A. LOCAL 

To run the self-prompting program LOCAL, enter LOCAL 
and then press RETURN. This procedure provides a 
convenient way to turn on smooth scrolling, for 
example. Enter a CONTROL-C to exit from this program. 

B. Machine Language Programs 

You can incoporate character I/O functions into your 
programs. Load the appropriate code(s) into Register 
E, load the appropriate function number into Register 

C. and call the BDOS routine at location 0005H. 

For example, the following machine language routine 
will clear the screen and home the cursor: 



0100 

0100 1E04 
0102 0E02 
0104 CD0500 
0107 C30000 
010A 



CLRSC 



ORG 0100H 
MVI E,004H 
MVI C,002H 
CALL 0005H 
JMP 0000H 
END 



*SET UP CTRL-D 
*SPECIFY CONSOLE OUTPUT 
*CALL BDOS ROUTINE 
*DO A WARM BOOT 



The next example moves the cursor to position 23 on 
line 14: 



0100 

0100 1E1B 
0102 0E020 
0104 CD0500 
0107 1E3D 

0109 0E02 
010B CD0500 
010E 1E2E 

0110 0E02 
0112 CD0500 
0115 1E37 
0117 0E02 
0119 CD0500 
011C C30000 
011F 



SETCR 



ORG 0100H 
MVI E,01BH 
MVI C,002H 
CALL 0005H 
MVI E,03DH 
MVI C,002H 
CALL 0005H 
MVI E,02EH 
MVI C,002H 
CALL 0005H 
MVI E,037H 
MVI C,002H 
CALL 0005H 
JMP 0000H 
END 



*SET UP ESCAPE 
*SPECIFY CONSOLE OUTPUT 
*CALL BDOS ROUTINE 
*SET UP = 

*SPECIFY CONSOLE OUTPUT 
*CALL BDOS ROUTINE 
*LINE 14 + OFFSETOF 32 
♦SPECIFY CONSOLE OUTPUT 
*CALL BDOS ROUTINE 
*COLUMN 23 + OFFSET OF 32 
♦SPECIFY CONSOLE OUTPUT 
*CALL BDOS ROUTINE 
*DO A WARM BOOT 
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TABLE 6-1 





VIDEO CONTROL 


CODES 




DECIMAL HEX 




CHARACTER 


CODE CODE 


DESCRIPTION 


CONTROL-A 


1 01H 


REVERSE VIDEO ON 
Presents dark 
characters on a green 
background. 


CONTROL-B 


2 02H 


REVERSE VIDEO OFF 
Displays green 
characters on a dark 
background. 


CONTROL-D 


4 04H 


VIDEO RESET 
The screen blanks, 
the cursor moves to 
the top left corner, 
and all parameters 
are reset to the 
default state: 

smooth scrolling 

off 

a utow rap-around 

off 

mask bit 7 on 

cursor on 

keyboard audio 

feedback off 

screen on 

reverse video 

off 

hybrid mode off 


CONTROL-E 


5 05H 


KEYBOARD AUDIO FEED- 
BACK ON 

When audio feedback 
is on a "click" will 
be heard every time a 
key is struck. 


CONTROL-F 


6 06H 


KEYBOARD AUDIO FEED- 
BACK OFF 

No sound is heard when 
keys are struck. 
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VIDEO 


CONTROL CODES 


(continued) 




DECIMAL HEX 




CHARACTER 


CODE CODE 


DESCRIPTION 


CONTROL-G 


7 07H 


BELL 

Sounds the standard 

bell tone. 


CONTROL-H 


8 08H 


BACKSPACE 

The cursor moves one 
space to the left. If 
auto-wraparound is on 
and the cursor is at 
the beginning of the 
line then a reverse 
line feed occurs and 
the cursor moves to 
the end of the 
previous line. No 
action occurs if the 
cursor is at the 
beginning of the line 
and auto-wraparound 
is off. 


CONTROL-J 


10 OAH 


LINEFEED 

The cursor moves down 
one line. If the 
cursor is on the top 
line, then the screen 






scrolls down one 
line, the top line is 
blanked, and the 
cursor does not move. 


CONTROL -K 


11 OBH 


REVERSE LINE FEED 
The cursor moves up 
one line. If the 
cursor is on the top 
line, then the screen 
scrolls down one 
line, the top line is 
blanked , and the 
cursor does not move. 
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VIDEO 


CONTROL CODES 


(continued) 




DECIMAL HEX 




CHARACTER 


CODE CODE 


DESCRIPTION 


CONTROL-L 


12 OCH 


FORWARD SPACE 
The cursor moves one 
space to the right. 
If auto-wraparound is 
on and the cursor is 
at the end of the 
line, then a line 
feed occurs and the 
cursor moves to the 
beginning of the next 
line. No action takes 
place if auto- 
wraparound is off and 
the cursor is at the 
end of the line. 


CONTROL-M 


13 ODH 


RETURN 

The cursor moves to 
the beginning of the 
current line. 


CONTRQL-N 


14 OEH 


CLEAR TO END OF LINE 
All c.h a r a c t e r s 
starting at the 
cursor position and 
continuing to the end 
of the line are 
erased. The cursor 
does not move. 


CONTROL-0 


15 OFH 


CLEAR TO END OF 
SCREEN 

All characters from 
current cursor 
position to the end 
of the screen are 
erased. The cursor 
does not move. 


CONTROL-Q 


17 11H 


SMOOTH SCROLLING ON- 
FAST 

Turns on smooth 
scrolling at fast 
speed. 
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VIDEO 


CONTROL CODES 


(continued) 




DECIMAL HEX 




CHARACTER 


CODE CODE 


DESCRIPTION 


CONTROL-R 


18 12H 


HYBRID MODE ON 
Thescreen is 
blanked, the top 200 
scan lines are 
reserved for 
graphics, the bottom 
4 lines are reserved 
for text and act as 
if they are the 
entire console, and 
the cursor is moved 
to the top text line. 
Smooth scrolling, if 
on, is suspended 
while hybrid mode is 
on. 


CONTROL-S 


19 13H 


HYBRID MODE OFF 
Places the screen 
back in TEXT mode. 
Subsequent line feeds 
will scroll all 24 
lines including any 
graphics image. If 
smooth scrolling was 






on prior to entering 
hybrid mode, then 
smooth scrolling 
continues. 


CONTROL-T 


20 14H 


SMOOTH SCROLLING ON 
Turns on smooth 
scrolling at slow 
speed. 


CONTROL-U 


21 15H 


SMOOTH SCROLLING OFF 
Subsequent line feeds 
will appear to be 
instantaneous. 


CONTROL-X 


24 18H 


CURSOR ON 

The cursor becomes 

visible. 
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VIDEO CONTROL CODES (continued) 





DECIMAL 


HEX 




CHARACTER 


CODE 


CODE 


DESCRIPTION 


CONTROL-Y 


25 


19H 


CURSOR OFF 

The cursor becomes 
invisible. All 
subsequent cursor 
controls work exactly 
the same way. 


CONTROL-X 


28 


1CH 


SCREEN ON 

Turns the video 

screen on. 


CONTROL-] 


29 


1DH 


SCREEN OFF 

Turns the screenoff. 
Characters on the 
screen are maintained 
in the video memory, 
and further output is 
also stored. When the 
screen is turned back 
on, all output will 
reappear. 


CONTROL-" 


30 


1EH 


HOME CURSOR 

Moves the cursor to 

the upper left corner. 


CONTROL-^ 


31 


1FH 


NEW LINE 

Has the effect of a 
return and then a 
line feed. 


ESC 


27 


1BH 


AUTO-WRAPAROUND ON 
Affects operations of 


$ 


36 


24H 


backspace (CONTROL-H) 
and f o r e s p a c e 
(CONTROL-L) . 


ESC 


27 


1BH 


AUTO-WRAPAROUND OFF 
Affects operations of 


% 


37 


25H 


backspace (CONTROL-H 
and forespace 
(CONTROL-L) . 
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VIDEO CONTROL CODES (continued) 





DECIMAL 


HEX 




CHARACTER 


CODE 




CODE 


DESCRIPTION 


ESC 


27 




1BH 


INSERT LINE 


L 


76 




4CH 




* or 








The line the cursor 


ESC 


27 




1BH 


is on and all lines 
below it move down 


1 


108 




6CH 


one line. The line 
at the bottom of the 
screen disappears. 
The cursor line is 
erased and the cursor 
stays where it is. 


* Either upper 


or lower 


case L. 




ESC 


27 




1BH 


DELETE LINE 


M 


77 




4DH 




** or 








All lines below the 


ESC 


27 




1BH 


cursor move up one 
line. The line at 


m 


109 




6DH 


the bottom of the 
screen is erased. 
The cursor stays 
where it is. 


** Either upper 


or lower 


case M. 




ESC 


27 




1BH 


DIRECT CURSOR 
ADDRESSING 


= 


61 




3DH 


The cursor moves to 
line Y, column X 


line (row) Y 


Y+32 






where the values used 


column X 


X+32 






are the actual 
values plus an offset 
of 32. 






EXAMPLE: 


To move the cursor 


ESC 


27 




1BH 


to line 14, column 23, 


= 


61 




3DH 


output the following 


line 14 


46 




2EH 


decimal values: 27 


column 23 


55 




37H 


61 (14+32) and . 
(23+32). 



ADVANTAGE 



6-10 



Graphics CP/M Preface 



VIDEO CONTROL CODES (continued) 



DECIMAL HEX 
CHARACTER CODE CODE DESCRIPTION 



DELETE 127 7FH DESTRUCTIVE BACKSPACE 

The cursor is moved 
back one character 
space and the 
character at the new 
cursor position is 
erased. 
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6.3 OVERVIEW OF THE GRAPHICS SUBSYSTEM 



The graphics subsystem includes two sets of functions: 
geometric routines and graphic support routines. The 
four geometric routines -- POLYGON, RECTANGLE, 
ELLIPSE, and SPECIAL LINE — enable you to draw 
points, lines, and a wide range of two-dimensional 
figures. The three graphic support routines — CLEAR, 
BLOCK, and CHAR -'- are also useful. CLEAR enables you 
to clear and scroll the screen to bring line to the 
top. BLOCK allows you to transfer a rectangular array 
of data between RAM and the screen, and CHAR permits 
you to display characters on the graphics screen. 

To incorporate these graphic routines in your 
programs: 

(1) Set the registers as described later, then call 
the graphic subsystem at 000CH. 

(2) Convert the program to a COM file, as usual. 

(3) The first time you run the program issue the 

command: 

GMGRADD your COMf lie 

This final step is necessary because the graphics 
subsystem does not permanently reside in memory. To 
conserve user RAM, this subsystem is only loaded into 
memory when it is needed. The procedure appends the 
graphics subsystem to the COM file, to provide that 
program with full graphic support. 



6.3.1 Geometric Functions: General 

Before drawing a geometric figure you must specify the 
viewport within which the figure will be displayed. 
The entire ADVANTAGE screen has a horizontal dimension 
of 640 pixels and a vertical dimension of 240 pixels. 
The viewport can include the whole screen or any 
rectangular portion of it. The viewport, though not 
displayed on the screen, establishes the boundaries 
within which any geometric figure is displayed. When 
you specify a figure, only the portion that falls 
inside the viewport will be displayed on the screen. 
No error message results if you specify a figure that 
excluded portion extends beyond the designated 
viewport; the excluded portion is simply not 
displayed. 
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A wide range of alternatives is available for 
presenting the interior and perimeter of a two- 
dimensional geometric figure. Depending on what pixels 
are turned on, the interior can be dark, wholly lit, 
or partially lit, with one of six shades of grey, or 
one of eight textures. The interior can either 
replace the current screen display or be superimposed 
on it. 

The perimeter can appear as a solid line around the 
interior, it can be shaded like the interior, or it 
can be omitted altogether. It is also possible to 
reverse the mode of the previous image, e.g., turn 
off, or omit, a perimeter that was shown as a solid 
line in the previous screen display. 

All four geometric routines use the command byte 
structure shown in Table 6-2 to determine how the 
figure will be displayed. This command byte is loaded 
in register C. 

A final general consideration applies to all four 
geometric routines. The HL register is loaded with the 
RAM start address of a table that contains the 
coordinates of: 

the vertices of a polygon, 

the opposite corners of a rectangle, 

the center of an ellipse, or 

the end point of a special line. 

The coordinate pair(s) X,Y consists of positive or 
negative two's complement 16-bit values. The 
coordinate values can lie anywhere between the decimal 
values -32,768 and +32,767, but only points whose 
coordinates fall within the viewport are displayed on 
the screen. 
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Table 6-2 

COMMAND BYTE STRUCTURE 
FOR GEOMETRIC ROUTINES 



76543210 


V D T P 




t 


i i 


l 1 


i A 










T> • T?T?T? TMTPTT?T? ntJT?!? JTT^M 




F! irljK±I v Iij ICjK UirJCiKAl 1UJM 








00 - Perimeter to be treated as interior 








01 = Perimeter on 








10 = Perimeter off 








11 = Reverse previous perimeter mode 








rn. TMrncDTno imjvmiinp 






X • JL JLH X JJi\X VJJL\ X XJ<fV X <«/ X\XJ 

0000 = Dark 






0001 






0010 






0011 = Shades of grey from dark to light 






0100 






0101 






0110 






0111 = Solidly lit 






1000 = Diagonal lines - negative slope 






1001 = Diagonal lines - positive slope 






1010 = Diamonds 






1011 = Checkers 






1100 = Little squares 






1101 = Dots & Dashes 






1110 = Vertical lines 






1111 = Horizontal lines 




Ul XlNXr».K.JLUI\ uxoruAi VHJUE* 




= Interior superimposed on existing 




screen image. 




1 = Existing screen image erased, and 




replaced by figure interior. 




T7-, '"T? , r x3 r TTr , TjLrr»oT>T 




V • oEil VXEiWirUKl 


= All operations except set viewport 


1 = Set viewport 


Note that when the command byte is 0, nothing happens. 
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I 1 t 1 t T 





imuiumimmu.i 



"n'-'uTriTrtTriniTrH 



p-<v- : :.-. : -:-.-:>?^ 




JJI.l i .HJH | j i |ni|.|I 






V r'VV rV'V* i 



i i « i.iti 



?"v"V*Y"y"""""T*'i> 

p' iu n. il m j j» — a 

ax a a a s a sa 
saaasaas: 

asrasaxa, 



a a a 



t a a: a_ai 

1 t ■ tl 



gaaaaaaaj 

osssasosi 
naaasaaa 

3SSSQS3Q; 

nananaaa, 



i i llml 









— - — - -~ 


- 


„„._.~~.~.~ 













VALUES FOR COMMAND BYTE DISPLAY 

PERIMETER ON 
01 =00000001 

05=00000101 



09=00001001 



13=00001101 



17=00010001 



21=00010101 



25=00011001 



29-00011101 



33=00100001 



37=00100101 



41=00101001 



45=00101101 



49-00110001 



53 00110101 



57 00111001 



61-00111101 



•iTivZ?£*>£:r*i?i?£? 




S^W 1 ^ 



V V "*. V "*. v . **. "•. 






lasaaaaaa 

a a a_a x a a a 
: m « asa a a a a 

a a a a a a a a 

a as a a a a a 
taaaaaaaa 

t a a a a a a a a 

a ■art a a a 



QDSQOODa 

nnnnnnoD 
"aaaaaaea 
aaaaaaaa 
aaaaaaaa 
anoonnna 



ill lii! 



PERIMETER OFF 
00=00000000 

04=00000100 

08=00001000 

12=00001100 

16=00010000 

20=00010100 

24=00011000 

28-00011100 

32=00100000 

36=00100100 

40=00101000 

44=00101100 

48=00110000 

52-00110100 

56 00111000 

60 00111100 



ADVANTAGE 



6-15 



Graphics CP/M Preface 



6.3.2 Geometric Routines - Input Parameters 



RECTANGLE 

The RECTANGLE function serves two purposes: it sets 
the viewport f and it draws rectangles. In both cases 
the sides must be parallel to the horizontal and 
vertical axes, X and Y, and the two points you 
designate are the opposite corners of the shape. It is 
possible to set the viewport and draw a rectangle in a 
single step. 

To set the viewport, specify a rectangle that does not 
exceed the size of the screen. If the input parameters 
specify a rectangle that extends off the screen, the 
previous viewport will not be changed and error code 
01H will be given. 

Input Parameters: 

Register Description 

A Set to a value of 2 - for RECTANGLE 

routine. 

C See command byte explanation. 

Set bit 7 to 1 to set the viewport. 
Set bit 7 to to draw rectangle. 
Set bit 7 to 1 to set viewport and 
draw rectangle simultaneously. 

HL RAM start address of 8-byte table 

containing coordinates of two points. 
Stored as XI, Yl, X2, Y2, these specify 
opposite corners of rectangle. 
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POLYGON 

The polygon routine draws points and lines as well as 
many-sided figures. This routine can only be 
guaranteed to succeed with convex figures. If you 
specify a concave figure r the graphics subsystem will 
attempt to draw it f but will return error code 02H if 
the effort fails. However, many concave polygons can 
be drawn as well as figures that are not well-defined 
polygons at all. 

A polygon is well-defined if it has one contiguous 
interior and exterior. A set of ten random points, for 
example, will probably not form a well-defined polygon 
when connected in the order given, since the interior 
may be several separate regions. This is not an error, 
and shading of the interior will still occur in a 
well-defined manner. The POLYGON routine fills in the 
polygon one horizontal scan line at a time, from top 
to bottom. At each scan line it finds all places where 
an edge intersects the scan line, pairs them off in 
order from left to right, and fills between each pair. 
To accomplish this, the program uses a variable-length 
list of 'active edges. 1 

Sometimes the complexity of the shape of the polygon 
may become so great that the list of active edges gets 
too long to fit in the program's internal buffer. When 
this happens, the extra buffer feature must be used 
(see Input Parameters). 600H bytes is the maximum that 
will ever be needed to handle polygons of 64 or fewer 
sides. Some examples of polygons that can be drawn 
without using the extra buffer feature are: 

1) Any 18 or fewer points whether or not they 
determine a well-defined polygon; 

2) 64 or fewer points defining a convex polygon, if 
interior is to be shaded; 

3) 64 or fewer points defining a perimeter only of 
any type of polygon. 
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Input Parameters: 

Register Description 

A Set to a value of 1 for POLYGON routine 



B 



HL 



Number of vertices: 

1 = a point 

2 = a line 

3 - 100 = a polygon 

Command Byte (plus, 
buffer) 



if bit 7 set, use extra 



RAM start address of table containing 
coordinates. These designate each 
individual point, or each endpoint for a 
line, or each vertex for a polygon. The 
table follows the form: XI, Y1,...XN, YN. 
Vertices must be specified in either a 
clockwise or a counterclockwise order. 



IX Starting address of extra buffer 

IY Length of extra buffer 

NOTE: IX, IY are ignored if bit 7 of C is off. 
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ELLIPSE 

The ELLIPSE routine draws ellipses, circles, arcs, pie 
slices, and areas enclosed by an arc and a 
subtended chord. The greatest and the least 
diameters are drawn parallel to the axes. 
This routine cannot be used to draw a 
rotated ellipse. 

For this routine, the vertical radius displayed on the 
screen has the value, i.e., the number of pixels, 




doubling of the specified horizontal radius makes it 
possible to draw a circle by setting the horizontal 
and vertical radii equal, even though the horizontal 
pixel density is twice the vertical pixel density. If 
either radius is zero, nothing is drawn. 
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Input Parameters: 

Register Description 

A Set to a value of 3 for ELLIPSE routine. 

B Set to a value of: 

= whole ellipse or circle; in this case 

IX and IY are ignored. 

1 = arc 

2 = pie slice 

3 = area enclosed by arc and subtended 

chord 

C See command byte explanation. 

D Set to half value of desired horizontal 

radius. Value is doubled in resulting 
figure. 

E Set to value of desired vertical radius. 

HL RAM start address of 4-byte table 

containing coordinates of center point. 
Stored as X f Y. 

IX Start angle (0-360). Ignore for whole 

ellipse or circle. 

IY Stop angle (0-360). Ignore for whole ellipse 

or circle. 

If IX or IY is greater than 360, the value mod 360 is 
used. 
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SPECIAL LINE 

The SPECIAL LINE routine provides a second method of 
drawing a line. The POLYGON routine allows you to draw 
a line by specifying its starting and ending points. 
The SPECIAL LINE routine draws a line with only the 
end point specified. The starting point is supplied by 
the end point of a previous line, drawn with either 
the POLYGON or SPECIAL LINE routine. If the last 
graphic command was a geometric routine that drew 
something other than a line f the line drawn with a 
SPECIAL LINE routine may start from an unpredictable 
location. The non-geometric graphic routines described 
below — CLEAR, BLOCK and CHAR — can be interspersed 
between SPECIAL LINE calls without losing track of 
where the next SPECIAL LINE should start. 

Input Parameters: 

Register Description 

A Set the value to 6 for SPECIAL LINE routine. 

C See command byte explanation. 

DE Set the value to the Y coordinate of end 

point. 

HL Set the value to the X coordinate of 

end point. 
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6.3,3 Other Graphic Support Routines 

The three additional graphic routines — CLEAR, BLOCK, 
and CHAR — are distinct from the geometric routines 
both in the capabilities they provide, and the 
structure of the command byte used in register C. 

The CLEAR routine does not use the command byte. The 
BLOCK and CHAR routines use the following command byte 
structure. 



Table 6-3 

COMMAND BYTE STRUCTURE 
FOR NON-GEOMETRIC ROUTINES 



76543210 
A Unused D X 



** 



*** 



X: DISPLAY MODE 

00 = overlay existing data 

01 = overlay inverse data* 

10 = inclusive-OR with existing data** 

11 = exclusive-OR with existing data*** 

D: DIRECTION MODE 

(not used by CHAR routine) 

= RAM to screen 

1 = screen to RAM 

A: ALTERNATE CHARACTER SET MODE 

= use standard character set 

1 = use alternate character set 



Each bit that is turned on in the RAM data is 
turned off on the screen, etc. 

The data in RAM is superimposed on the screen 
image, without erasing the previous display. 

If an individual bit in the RAM data is turned 
on, the corresponding bit on the screen display 
is reversed. If the individual bit in RAM is 
turned off, it does not affect the screen 
display. 
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CLEAR 

The CLEAR routine clears the screen and scrolls it to 
line 0, In other words, if you had previously used a 
character I/O function to scroll the screen up so that 
line 10 appeared on the top of the screen, the CLEAR 
routine would restore the screen to its default 
setting, with line positioned at the top of the 
screen. 

This routine does not use the command byte at all. 

Input Parameter: 

Register Description 

A Set to a value of for CLEAR routine. 
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BLOCK 

The BLOCK routine makes it possible to move a 
rectangular array of data between main RAM and the 
screen. The data transferred is always a multiple of 8 
bits. The data in RAM is stored starting from the 
upper left byte down to the lower left byte. It then 
continues down one column after another finishing at 
the lower right byte. 

The data can be placed in a block anywhere on the 
screen. The position of the block is determined by the 
coordinates of the upper left hand corner of the 
block. 

BLOCK uses the entire display memory, the 240 visible 
lines of pixels, as well as the 16 invisible lines at 
the bottom of the screen. If the data reaches the 
bottom of the screen, the transfer operation will 
write on the invisible lines, then wrap around to the 
top of the screen. 

Input Parameters: 

Register Description 

A Set to a value of 4 for BLOCK routine 

C See command byte explanation 

D Set to width of block in 8-bit columns 

E Set to height of block in lines 

HL RAM start address of block 

IX X coordinate of upper left corner of block 

in screen display. Data transfer between 
RAM and screen occurs with exceptional 
speed when IX is an exact multiple of 8 and 
the block is aligned on byte boundaries. 

IY Y coordinate of upper left corner of block 

in screen display in lower 8 bits of IY. 
The upper 8 bits of IY are ignored. 
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6.3.5 How Descenders are Displayed 

If bit 7 of byte 1 (represented in the grid by a *) is 
1, the character matrix will begin in ROW2 and will 
end in R0W8. If bits 7 and 6 of byte 1 represented in 
the grid by * and ** are 1, the character matrix 
will begin in R0W3 and will end in R0W9. Row is 
always blank. The value of bits 7 and 6 of bytes 2, 
3, 4, 5 f 6, and 7 has no effect on the displayed 
character. 
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DISKETTE ERROR HANDLING 



7.1 DISKETTE ERROR CODES 

***** ADVANTAGE CP/M reports diskette errors just as North 
Star GDOS does. The error message format remains: 

T x D y S zzz 

where x= error type; y= number of the floppy disk 
drive where the error occurred; and zzz= the decimal 
address of the sector where the error occurred. The 
error codes and their meanings follow: 



NOTE 


For purposes of error 
drives are numbered 
lettered. Floppy disk 
etc. 


messages, the 

rather than 

drive 1 = A, 



T = 1 SYNC BYTE NOT FOUND 

Indicates that the diskette was not properly 
loaded into the floppy disk drive, the diskette 
was not initialized, or data was badly written on 
the diskette 

2 CRC COMPARE ERROR 
Indicates badly written data. 

3 VERIFY COMPARE ERROR 

Indicates that data just written on the disk does 
not match RAM. "Seek error." 

4 NO INDEX PULSE 

Indicates that the wrong type of diskette or a 
badly seated diskette was present. 

5 DENSITY MISMATCH 

Indicates that single-density data was found. 

6 WRITE-PROTECT 

Indicates that a write operation was attempted on 
a write-protected diskette. 
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7.2 RESPONSES TO ERROR MESSAGES 

You have several options when an error message 
appears, 

7.2.1 Retry 

Errors may occur because the diskette is improperly 
seated. Remove the diskette and replace it carefully. 
Press RETURN or type any other key (except Control-C 
or Control-A), and the computer will retry the 
operation. This procedure can be repeated any number 
of times and should always be your first response. 
Repeated failures may require more drastic measures. 

7.2.2 CONTROL-C: Warm-Booting 

Warm-booting the system will abort whatever program is 
running and return control of the computer to the 
Console Command Processor. Resolve the problem that 
prompted the error message before trying to run the 
program again. 

7.2.3 CONTROL-A: Forcing Acceptance of Bad Data 

This extreme response should be reserved for 
emergencies. Forced acceptance of bad data violates 
data integrity, and can lead to unpredictable results 
or outright disaster. Nevertheless, CONTROL-A does 
make forced acceptance possible, except in Sector 
which cannot be forced. 

Do not write new data onto a disk after forcing 
acceptance of bad data. 

It is a good idea to perform a surface check using the 
COPY program right after any non-recoverable errors 
occur. Differences in hardware tolerances can mean 
that one drive can read a diskette but another drive 
cannot. In such cases, if you have a standard 
ADVANTAGE with two floppy disk drives, use the COPY 
program to read the marginal diskette from the 
compatible drive, and make a copy on the incompatible 
drive. 
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PATCHING OR DYNAMICALLY ALTERING CP/M 



Only those with experience should undertake the 
procedures described below. This section explains how 
to alter CP/M to accomodate non-standard peripherals 
and how to initiate changes such as a turn-key start. 
This discussion presupposes considerable familiarity 
with operating systems, software development, and 
CP/M. 



8.1 DISK MAP AND RAM IMAGE LOCATIONS BY COMPONENT 

Tracks and 1 (sectors 4-19) are called the "system 
tracks". These are accessed only by CPMGEN, SYSGEN, 
COPY and FORMAT. The remainder of the disk is managed 
by CP/M through the BIOS which applies a 5 sector 
skew. 



Component Name 



Disk 
Sectors 



RAM Image 
Address After 
SYSGEN 



Address in 
standard 
ADVANTAGE 
64K system 



DOS Directory 

Graphics CP/M Bootstrap 4 - 4.5 
Console Command 

Processor (CCP) 9-12 

BDOS 13- 19 

BIOS- disk portion 4.5-7 

USER-Sequential I/O 8 

BIOS- upper portion 1-3 

console section 
Buffer & Scratch space not on disk 



Not Applicable 
1400H 

1500H 
1D00H 
2B00H 
3200H 
3400-39PF 



Not Applicable 
ECOOH briefly 

D700H transient 
DFOOH resident 
EDOOH resident 
F400H resident 
F600 resident 

FCOOH-FFFFH 



CP/M Directory 20 , 21, 25, 26 (normal skew of 5) 

CP/M Data in 2k blocks 22,27,23,28 then 24,29,30,35,31,36 
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8.2 BIOS AND USER AREA ADDRESSES OF INTEREST 



At the end of the disk BIOS. are several locations that 
may be of interest for patching. These are shown below 
at their system generation locations. 



31EA 
31ED 
31F0 

31F8 
31F9 
31FF 



C9 DISKERR 
C9 JINIT 
C9 OFTEN 



00 CONFG 

01 CNTRLA 
?? OPTION 

; 80H = Multi 
(set 
is pr 
40H = Read- 
10H = Inter 
02H = Auto- 
01H = Auto- 



RET ;Disk errors may be intercepted here 
RET ;Control comes here at each boot 
RET ;Disk handler calls "often" at least 

every 40 msec 
DB ;Like DOS CONFG byte 
DB 1 ;See disk error interception below 
DB ? ;Option flag meaning: 

-drive simulation with one drive system 

automatically by CPMGEN when only one drive 

esent) 

after-write option requested in CPMGEN 

rupts to be enabled after disk access 

start on warm-boot 

start on cold-boot 



3200H is the beginning of the user area and its jump 
table vector. The start of the user area is a jump 
table, which follows* This example is for a 64K 
system. 

Cold-boot init for US ART & Parity setup 
Get Console Status - A=0 or FF 
Console Input from the Standard Port 
Console Output to the Standard Port 
Printer output to board 1 
CP/M punch device to board 2 
CP/M "Reader" to board 2 
Dummy Printer status test, always 

Hooks into upper BIOS are provided in the CP/M 
documentation package.. 



F400 


JMP 


INIT 


F403 


JMP 


CONTST 


F406 


JMP 


CINL 


F409 


JMP 


COUTL 


F40C 


JMP 


COUTR 


F40F 


JMP 


COUTL 


F412 


JMP 


CINL 


F415 


JMP 


PRTTST 
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8.3 PATCHING IN AUTO-START 

The auto-start facility is enabled by turning on the 
bit flag in the option byte. If the flag is turned on, 
the Console Command Processor will then try to load 
AUTO.COM from logical drive A and execute it. Value 
(01H) causes auto-start on cold boot only. Value (02H) 
causes an auto-start every time the system is warm- 
booted. 



CAUTION 


AutC 
you 


>-start 
control 


on 
of 


warm-boot 
CCP. 


never 


gives 



You can alter the default command AUTO to any string 
of up to 128 bytes. Put the string length at 1507H. 
Put the string itself from 1508H to 1587H. For 
example, put "MBASIC B:MYPROG n at 1508H, so MBASIC can 
auto-start MYPROG on drive B. Make the length byte at 
1507H correspond by setting it to OFH. 



8.4 SYSTEM PATCEING PROCEDURE 



Start with 
in floppy 
supplied 



a working copy of the CP/M System Diskette 
disk drive 1. Do NOT use your factory 
CP/M System Diskette for this purpose. 



Run SYSGEN, or CPMGEN. 



1. Tell SYSGEN (or CPMGEN) from which drive it must 
read the system. If you simply want to read CP/M 
from the system diskette in floppy disk drive 1, 
type a 1. 

2. Ensure that the input diskette is loaded and 

press RETURN. The system tracks will be read into 
RAM at 1400H-39FFH. 

3. SYSGEN prompts you to output the system or boot. 
Since you have yet to patch, enter CONTROL-C to 
warm-boot. 
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Run DDT. It loads below 1400H so the system RAM image 
remains untouched. Apply your patches, for example, as 
follows: 

S31FF Allows you to set the Option Byte 

41 Turn on auto-start and read-after- 

write 

Enter a CONTROL-C to warm-boot the system. 

Run SYSGEN again. 

1. Bypass the request for the input drive number by 
pressing RETURN. Otherwise you would read over the 
patched RAM image. 

2. Specify the output drive number. 

3. Load a FORMATted diskette to receive the system. 
It is inadvisable to write on the working system 
diskette in floppy disk drive 1 unless you have 
copies of it. 

4. Confirm with RETURN. 

5. SYSGEN now writes the patched systemy which you 
then can cold-boot and exercise. 



8.5 ALTERING THE BIOS DYNAMICALLY 

8.5.1 General Information 

Location contains a jump to the third byte of the 
BIOS (warm-boot entry point). To access the OPTION 
byte, you could specify and assemble: 



LHLD 1 

LXI D, 06FFH-3 

DAD D 



HL = address of BIOS + 3 
Offset to option byte 
Add to HL 



HL now points to the OPTION byte. 
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8.5.2 Dynamic Modification of the Error Interception Feature 

Disk errors can be intercepted at DISKERR (BIOS + 
06EAH) r to use a user supplied error message. The 
instruction at DISKERR is called twice for each error, 
unless you keep control of the processor. 

Before the error message is displayed, the instruction 
is called with A = the error type, HL = pointer to the 
standard message, and the Z flag off. 



***** 



If A is still non-zero when the error interception 
program returns control to the BIOS error handler, the 
message that HL points to will be printed until a zero 
byte terminates the message string. This allows you to 
substitute your own message for the standard error 
message. 

After the message is displayed, DISKERR is called 
again. Now A will be and the Z flag will be on. If 
you return with A still equal to 0, the console will 
be queried for error disposition. If A does not equal 
0, then A is treated as if it were a console response. 
If A = 3 (CONTROL-C) , a warm boot will result. If A = 
1 (CONTROL-A), forced acceptance results. Any other 
value leads to a retry, which is not recommended. 

The following is a sample intercept to accept all 
errors. Implementation of such a procedure is very 
risky, and therefore is not recommended. It is shown 
only as an example. 



MYDERR 



RNZ ;Do not intercept when AO0 

MVI A,l ;On second call, tell BIOS we 

accept the error 
STA ERRMARK ;Set flag to myself 
RET ;Since A=l, force acceptance 

of bad data 
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8.6 REPLACING THE USER AREA TO SUPPORT NON-STANDARD SEQUENTIAL 
DEVICES 

1. Edit and assemble your- new user code. Its origin 
should be: 

(MEMSIZE$IN$KB*400H) - 0C00H for diskette 

2. Get a standard system memory image loaded at 
1400H-39FFH by using SYSGEN or CPMGEN. 

3. Use DDT to overlay the old user area at 3200H to 
33FFH. Since the origin is not at 3200H, you must 
use an offset in DDT's R command. 

Use the H command to calculate it by entering: 

H3200 YOURORG 

DDT calculates the sum first and the difference 
second. Use the second number in the R command. 
For example: 

DDT 

H3200 F400 

(DDT responds 2600 3 EOT)"" - use the 3E00) 

IUSER.HEX 

R3E00 

CONTROL-C 

4. Run SYSGEN to write the system. 
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THE RELATIONSHIP BETWEEN CP/M AND HARD DISK GDOS: 
CONNECTIONS AND ALLOCATIONS 



9,1 INTRODUCTION 

The North Star CP/M interface to the hard disk offers 
several useful features. 

A. You can divide the hard disk drive into multiple 
CP/M "logical drives". 

B. You control the characteristics of the logical 
drive, both its total size, and the size of the 
CP/M block that governs allocation of storage 
space. 

C. A logical drive can be lengthened if space remains 
available. 

D* You can share the hard disk with North Star 
software other than CP/M. 

The GDOS hard disk file becomes the functional 
equivalent of CP/M's logical drive. The GDOS file is 
designated by a pathname, the CP/M logical drive by a 
unit letter. 



9.2 CONNECTIONS 

You can pick any name you choose for a hard disk GDOS 
file, with the limitations that it cannot begin with a 
numeric, contain an embedded blank, or consist of more 
than 14 printing characters. Since CP/M can handle a 
maximum of 16 units at any time, the CP/M logical 
drive is designated by a single letter, in the range 
A-P. The minimum designation would be a floppy disk 
drive with a logical unit name of A, since, for warm 
boot purposes, there must always be a connection to A. 

***** As you have already seen during the initial CP/M 
start-up procedure, establishing the connection 
between the Graphics DOS pathname and the unit is 
quite simple. The format is: 

Unit letter: Pathname 

We have already worked with the suggested connections, 
A:CPMUNITA and B:CPMUNITB. 
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9.2.1 The Table of Connections and the Work File 

The table of connections built during the HDBOOT is 
stored in a GDOS workfile y.ou name during the CPMGEN 
process. You can assign this file a particular name 
if you choose. Otherwise the default name CPMWORK 
is used. 

If you are using the subset of hard disk GDOS embedded 
within CP/M, all workfiles must be put in the hard 
disk SYSTEM account. Any attempt to create an 
alternate pathname during CPMGEN will result in an 
error during the HDBOOT procedure. 

If you are using the complete hard disk GDOS, you may 
establish separate accounts to contain various CP/M 
workfiles and units using the GDOS Account Create (AC) 
***** command. See Chapter 6 of the North Star ADVANTAGE 
Graphics DOS Manual for a discussion of each of the 
GDOS account commands. 

***** Each CP/M system diskette that you use with the hard 
disk units must contain a work file pathname that 
points to a table of CP/M unit connections located on 
the hard disk. It is very convenient and useful to 
establish different work file names and supply 
different tables of co n n e c t i o n s f or s e par a t e C P/ M 
system diskettes. 

For example, on one diskette you might call the work 
file LEDGER, and build a table of connections that 
groups together accounting programs and associated 
data files. 

The work file on another CP/M diskette might be named 
WP, for word processing, and the table of connections 
it contains might group together your word processing 
programs and text files. Thus, you can define as many 
different work files, and build as many different 
tables of connections, as your application of CP/M 
requires. 



9.2.2 Reviewing The Connection Table 

If the connections you assign are permanent, you can 
direct HDBOOT to implement the connection table 
automatically, on every cold boot. 

To make your connections permanent, when you receive 
the HDBOOT prompt: 
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ENTER "N" TO MAKE FUTURE BOOTSTRAPS NON-STOP 
ENTER "B" TO REVIEW CONNECTIONS EVERY COLD-BOOT 

You should enter: 

N 

If you want to change existing connections, or make 
temporary ones, you can review and modify the table 
each time you cold boot the system. You should enter: 

B 

to the "N" or "B" prompt. 

To force review of the table, simply execute the 
HDBOOT program. Whenever you run HDBOOT, you must 
place the CP/M system diskette in floppy disk drive 1. 

9.2.3 Altering the Connections 

If you want to add a new logical drive, up to the 
maximum of 16, you can simply use the format shown 
above: 

Unitletter : Pathname 

For example, to connect CP/M logical drive G to the 
GDOS pathname TAXES, SYSTEM type: 

G: TAXES 

Since CP/M can handle a maximum of 16 logical drives 
at any given moment, you can change the connections 
periodically to access all your programs and data 
files if your library of software consists of many 
logical drives. 

If your application software runs under CP/M logical 
drive letters embedded in the code, you may have to 
use drive letters more than once. You could assign 
the appropriate connections each time you cold-boot 
the system, but it is easier to build several CP/M 
system diskettes with different work file names on 
each one. 
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To delete a connection, simply type the unit letter 
and press RETURN. For example, to delete the 
connection E:CPMUNITE enter: 

E: 
To replace a connection, enter it as a new connection. 



9.3 ACCOUNTS AND DRIVE NUMBERS 

If you are using the complete version of GDOS and CP/M 
is going to share space on the hard disk with non-CP/M 
software such as GHBASIC, you should use GDOS to 
create a CP/M account. For example, enter: 



=>AC CPM 



You must 
a pa 
example, 



[iust then qualify the account name when you create 
rticular GDOS file within this account. For 



=>CR CPMUNITA,CPM 



If you do not specify the account name, the default 
value, "SYSTEM" will be supplied automatically. Since 
you have only one hard disk drive you do not have to 
supply the hard disk drive number as part of the 
pathname. 

If you use only the subset of GDOS embedded within 
CP/M, you cannot designate the account name or drive 
number. 



9 . 4 ALLOCATION 



When CP/M is used with diskettes, the characteristics 
of the CP/M logic are fixed. The storage capacity of 
the logical drive automatically equals the storage 
capacity of the diskette in the drive. On a hard 
disk, however, the capacity of the logical drive must 
be defined, since it could be as little as 9 
Kilobytes, or as much as 5 Megabytes, 

CP/M manages disk use by means of a disk directory. 
Disk directory entries point to CP/M disk allocation 
blocks. CP/M for diskette allocates storage space in 
small blocks of 2K for quad-capacity diskettes. 
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On the hard disk, the size of a CP/M block can vary 
from 2 Kilobytes to as much as 16 Kilobytes. It is 
important to remember that although the size of a CP/M 
block can vary from one logical drive to another, the 
size must remain constant within each logical drive. 



9.4.1 Allocating CP/M Logical Drive Capacity and Block Size 

Clearly, using CP/M with a hard disk not only permits, 
but actually requires, a much greater flexibility in 
the use of storage space. North Star provides you 
with a range of options for handling the storage space 
on the hard disk. The various possibilities are 
tabulated below. The significance of the 8 versus the 
16 bit CP/M block addresses is explained in section 
9.4.3 below. 



Table 9.1-8 Bit CP/M Block Addresses 



CP/M Unit 


CP/M Block 


GDOS "len" in 


Allocation 


in Kilobytes 


Size in 
Kilobytes 


256 byte blocks 


Factor 


Min 


Max 


Min 


Max 


9 


256 


1 


36 


1,024 


1 


10 


512 


2 


40 


2,048 


2 


12 


1,024 


4 


48 


4,096 


4 


16 


2,048 


8 


64 


8,192 


8 


32 


4,096 


16 


128 


16,384 


16 





Table 


9.2 - 16 Bil 


t CP/M Block Addresses 


CP/M Unit 
in Kilobytes 


CP/M Block 
Size in 
Kilobytes 


GDOS "len" in 
256 byte blocks 


Allocation 
Factor 


Min 


Max 


Min 


Max 


514 
1,028 
2,056 
4,112 


2,062 
4,124 
8,192 
8,192 


2 

4 

8 

16 


2,056 

4,112 

8,224 

16,448 


8,248 
16,496 
32,768 
32,768 


2 

4 

8 

16 
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In general, your choice of the appropriate block size 
will be shaped by the trade-off between two 
considerations: the desirability of storing small 
files with minimum breakage, to reduce breakage and 
space allocated but unused at the end of the file; and 
the desirability of addressing large files with as few 
directory entries as possible, to reduce program 
overhead, and wasted directory space. 

For example, if the CP/M block size for a logical 
drive is 2K, a 9K file will consume 10K of storage; 
space. If the CP/M block size for the same logical 
drive is 8K, the same file will require 16K for 
storage. 

To pick the most advantageous block size and logical 
drive capacity, consider the number and size of the 
programs and files you intend to store on that logical 
drive. If you want to put sizeable files on a logical 
drive efficiently, use a CP/M block size of 16K. 

9.4.2 Lengthening The Unit Size 

North Star CP/M for hard disk offers you a further 
convenience, the option of, increasing the storage 
capacity of an existing logical drive. Take a logical 
drive whose initial capacity was set at 2 Megabytes, 
or 8,000 GDOS blocks, with an allocation factor of 16. 
You might fill this logical drive with data, then 
realize that you need an additional 2 Megabytes of 
storage space to accommodate the rest of the 
information you want to include. 




command (SL) gives you this option, within certain 
bounds. 

Just as you specified the original capacity of the 
CP/M logical drive in terms of its "len" in GDOS file 
blocks of 256 bytes, so you extend the logical drive's 
capacity by specifying the desired size in GDOS file 
blocks. The CP/M block size, or allocation factor, 
must remain the same. 

The amount a given logical drive can by extended 
depends on the ratio you first established between the 
drive size and the CP/M block size. 
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9.4.3 8 Bit Versus 16 Bit CP/M Block Addresses 

Logical drives fall into two different categories, as 
shown in the tables above. There is a lower range, 
and an upper range. 

This differentiation exists because CP/M chooses 
either 8 or 16 bit numbers for CP/M block addresses in 
a drive's directory, on the basis of the ratio between 
the drive size, and the CP/M block size. 

For example, a logical drive with a capacity of 3000 
Kilobytes and a CP/M block size of 16K would fall into 
the lower range (Table 9.1). Such a logical drive 
could later be extending to a maximum length 4,096 
Kilobytes. 

A logical drive with the same original capacity, 3000 
Kilobytes, but a CP/M block size of 8K would fall into 
the upper range (Table 9.2). This latter drive could 
be extended to a maximum of 4 Megabytes. A logical 
drive that initially falls into the lower range cannot 
be extended into the upper range, since this would 
invalidate the existing directory for the drive. 

Consequently, whether and how much you could extend a 
2 Megabyte logical drive would depend on the CP/M 
block size you had originally selected. If you 
selected a CP/M block size of 8K, the logical drive 
would fall into the lower range, and could only be 
extended to 2048 Kilobytes, a very marginal gain. If 
the original allocation was 2062 Kilobytes it could be 
extended to 4 Megabytes. 

If you try to extend an existing logical drive beyond 
the maximum, HDBOOT will implement the defined maximum 
value, and warn you that you are wasting space. 

Some further examples of this process of connection 
and allocation are given below. 

1 . The GDOS command : 

=CR TINY 100 1 

will create a GDOS file that contains 100 GDOS 
file blocks, each containing 256 bytes. The total 
capacity, of the corresponding CP/M logical drive 
will be 25 Kilobytes. The allocation factor of 1 
will cause the space to be allocated in CP/M 
blocks of IK. 8 Kilobytes will be used in the 
directory, so STAT will report 17 Kilobytes free. 



ADVANTAGE 9-7 Graphics CP/M Preface 



2. The GDOS command: 

=CR HUGE 5600 4 

will create a GDOS file containing 5600 GDOS file 
blocks, each with 256 bytes. The corresponding CP/M 
logical drive will have a total capacity of 1400 
kilobytes. The allocation factor of 4 will establish 
a CP/M block size of 4 KB. This logical drive could 
be extended to a maximum of 4124 Kilobytes with the 
GDOS command: 

=SL HUGE 16496 
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9,5 HARD DISK SYSTEM PATCHING INFORMATION 



***** 



The standard hard disk ADVANTAGE is assumed to have 
exactly 64 Kilobytes of RAM. You are allowed to 
specify a smaller CP/M to CPMGEN to preserve RAM above 
CP/M for spoolers, oversize SBIOS, etc. The Hard Disk 
BIOS Extension is fixed at the top of the 64K RAM area 
- from F300H to FFFFH. 



EXAMPLE: a 56K CP/M would leave the space between 
CFOOH to D2FFH available. 

DISK MAP AND RAM IMAGE LOCATIONS BY COMPONENT *** HARD DISK 



Component 


Sector 


RAM image 


Addr in a 


Name 


on Disk 


addr after 


64K Hard 






CPMGEN 


Disk 
System 


DOS Directory 





N/A 


N/A 


CP/M Bootstrap 


4 


1400H 


ECOOH briefly 


Con Cmd Proc (CCP) 


9 


1500H 


BAOOH transient 


BDOS 


13 


1D00H 


C200H resident 


BIOS-disk portion 


4+100H 


2B00H 


E000H resident 


SBIOS-sequential I/O 


8 


3200H 


E700H resident 


BIOS - upper portion 






E900H resident 


Spec Sys Area 


8+180H 


3380H 


F300H initially 


Buffer & Scratch 


not on d 


isk 


FCOOH-FFFFH 



The Special system area intrudes upon the SBIOS (often 
called the USER area). It provides the CP/M Work-File 
pathname, some addresses within the BIOS, and code 
which causes CCP to load HDBOOT at a cold boot. After 
HDBOOT is complete, the area is free for use by other 
code - e.g. video-board custom SBIOS. If you clobber 
the Work-File pathname, you may not start HDBOOT.COM 
again (as in the Alternative Procedure) . 



DEBUGGING NOTE: 

Saving low RAM (the TPA) after a blowup for a post- 
mortem analysis is easily done with a diskette-only 
system since CP/M is only loaded in high RAM. The 
HDBOOT process uses low RAM so the cold boot and Save 
trick will not work unless you cold boot a non-hard 
disk CP/M system. 
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SUBSET GRAPHICS DOS COMMAND PROCESSOR 10 

10.1 OVERVIEW 

This subset of the hard disk version of the Graphics 
DOS command processor allows you to work with files on 
the hard disk by entering selected GDOS commands from 
the keyboard. When you press the RETURN key r the 
command and its arguments are processed and executed. 
If the command is invalid, the system returns an error 
message to the console. 

Using these hard disk GDOS commands, you can: 

* Create and delete CP/M units as GDOS files. 

* List the file directory. 

* List hard disk statistics. 

* Obtain help for the subset GDOS commands. 

* Return to CP/M 

10.2 SYMBOL CONVENTIONS 



When the syntax of a hard disk GDOS command is given 
in this section, the commands and words indicated with 
uppercase letters must be entered exactly as shown. 
Words or arguments which require a value are indicated 
in lowercase. For example, the command syntax: 

HE {[command]} 

means that you must enter the letters HE followed by a 
valid command name. In the command: 

HE LI 

***** the command name LI replaces "command". 

Certain optional arguments refer to the hard disk. 
These arguments are surrounded by square brackets [ ]. 

Other optional arguments listed with the HElp command 
refer to diskettes and are surrounded by braces { }. 
Ignore these references to diskettes if you are using 
subset GDOS, since the subset commands are only 
applicable for hard disk use. 
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If an argument has both braces and square brackets, as 
in: 

HE { [command] } 



the argument is optional for hard disk. 
10.3 ARGUMENTS 



Subset Graphics DOS command arguments, and the rules 
that govern them, are described below. 

In general, numeric values that refer to disk 
addresses are expressed in decimal notation. Numeric 
values that refer to RAM or port addresses are usually 
expressed in hexadecimal notation. Any numeric 
argument (except a hard disk drive number appended to 
a file name or an account name) can be entered in 
hexadeciaml notation if immediately followed by an H, 
or decimal notation if followed by a T. 

Example: 

CR JONES 20H 

This command creates a 32-block (20 Hex) file named 
JONES in the hard disk SYSTEM account. Ordinarily the 
length of the file is specified in decimal notation. 
If you specify hex notation, GDOS makes the conversion 
to decimal notation for you. 

Argument Description 

#n Refers to an I/O device number from to 

6 inclusive. Generally, n is optional and 
defaults to 0. Hard disk GDOS assigns 
specific device numbers to specific 
peripheral devices. If your system has 
been customized, your device numbers may 
be different. The assigned device numbers 
are: 

= Console terminal 

1 = Printer 

2-6 (not implemented by North Star) 
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Argument 
d 
filename 



pathname 



Pescrjption 
Hard disk drive number 101. 

Name of a file on hard disk. The filename 
may be from 1 to 14 printing characters. 
In Graphics CP/M using the GDOS subset, 
the filename corresponds to a CP/M 
unitname. 

Uniquely identifies a file on the hard 
disk within the SYSTEM account. A hard 
disk pathname consists of a filename 
optionally followed by a comma, the 
accountname SYSTEM, another comma and 
hard disk drive number 101. The subset of 
hard disk GDOS creates pathnames only 
within the default SYSTEM account. 



For example, 
pathnames: 



the following are all valid 



TESTFILE6 
PAYROLLPROGRAM 
JONES, SYSTEM f 101 
jones, SYSTEM 



1 en- 



alloc 



Upper and lowercase letters are different 
in a pathname. If you create a file named 
JONES, you cannot later refer to it as 
jones. 

Length of a file or part of a file on 
hard disk (in blocks of 256 bytes) 
expressed in decimal notation. 

is the size, in DIBs (Data Incremental 
Blocks) of the areas on the hard disk 
allocated to a file. A DIB is a group of 
sixteen contiguous 8K byte sectors. The 
allocation factor is the number of DIBs 
grouped into a contiguous area or 
"Segment" on the hard disk. 
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Arg u ment 



Pescrj,ption 



Valid allocation factors are 1 (default) , 
2, 4, 8, and 16. An allocation factor of 
8 will put segments on a hard disk 
consisting of eight DIBs times sixteen 
sectors per DIB, for a total segment of 
128 sectors. 

If the file uses more than one megabyte 
of disk space, specify an allocation 
factor greater than 1. The allocation 
factor is approximately the same number 
as the maximum megabyte size by which a 
given file could expand. 



raddr 



RAM address. The RAM address is usually 
expressed in hexadecimal notation (00- 
FFFF). 
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10.4 COMMANDS 



10,4.1 File Commands 



These commands allow you to create new hard disk 
files, change the size and attributes of existing hard 
disk files, and delete specified hard disk files. 



CR Create File 



This command creates a new file on the hard disk. The 
allocated file space is completely initialized to 
zeros. The syntax of the CR (Create) command is: 



CR pathname len [alloc] 

where: pathname identifies the hard disk file to be 

created. 

len is the length of the new file in 
file blocks of 256 bytes each. 

alloc is the allocation factor. 



Example 1: 

CR DATA, SYSTEM, 101 10 

A new file named DATA is created in the SYSTEM account 
on hard disk drive 101, and given a length of 10 
blocks. 

Example 2: • 

CR CPMUNITA 2056 2 

A new GDOS file named CPMUNITA is created on the hard 
disk in the default account SYSTEM. The length of the 
file is 2056 blocks and space is allocated in segments 
of two DIBs (32 sectors) each* 
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SL Set Length 



This command changes the length of a file to the 
specified length. The syntax of the SL (Set Length) 
command is: 

SL pathname len 

where: pathname identifies the hard disk file. 

len is the new length of the file, 
specified in blocks and assumed to 
be decimal. 

Example: 

SL JONES2 16 

A file named J0NES2 in the default SYSTEM account has 
its file length changed to 16 blocks of 256 bytes 
each. 

DE Delete File 

This command deletes any file on hard disk that has 
the attributes Read/Write and Deletable. The syntax 
of the DE (Delete) command is: 

DE pathname 

where: pathname identifies the file to be deleted. 

Example 1: 

The command: 

DE DATA, 101 

deletes the file named DATA from hard disk drive 101. 

Example 2: 

The command: 

DE CPMUNITA 

will delete the GDOS file named CPMUNITA in the 
default hard disk SYSTEM account. 
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10.4.2 Program Execution 



JP 



Jump to a RAM Address 



The JP command executes programs currently in RAM by 
jumping to the specified RAM address. The syntax of 
the JP (Jump) command is: 



JP raddr {args} 
where: raddr 
args 



is the RAM address. 

are the arguments to be sent 
to a program through the 
command string. 



You can send arguments to the program as part of the 
command line. JP sets the HL register pair to point 
to the remainder of the command string. 



10.4.3 Listings And Statistics 



These commands enable you to list the hard disk file 
directory and determine the available work space in 
RAM. 



LI 



List File Directory 



This command produces a directory listing from the 
SYSTEM account on hard disk. The syntax of the LI 
(List File Directory) command is: 



LI {[#n]> [account] 



where: 



n 



account 



is the output device number on which 
the directory is displayed or printed. 

optionally identifies the SYSTEM 
account. If no account is specified, 
the command defaults to the SYSTEM 
account. 
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For each file in a hard disk directory the LI command 
displays: 

Filename 
. Length in blocks 

Allocation factor in DIBs 

Attributes 

S = Scratch 

W = Read/Write 

U = Updated but not backed up 

D = Deletable 

File type 

Example 1: 

LI #1 SYSTEM 

The directory for accountname SYSTEM is printed on the 
printer. 

Example 2: 

LI 

All the files in the default account SYSTEM are listed 
on the ADVANTAGE console. 

ST Display Hard Disk Statistics 

This command prints hard disk statistics on the number 
of bad spots, system overhead on the disk, and used 
and unused disk space. The syntax of the ST 
(Statistics) command is: 

ST [d] 

where: d is 101, the hard disk drive number. 

The ST command displays all hard disk statistics in 
DIBs. 

Example: 

ST 
could produce the following output to the console: 

BAD: 1 OVERHEAD: 9 USED: 162 UNUSED: 139 
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10.4.4 Miscellaneous Commands 
HE Help 



When this command is used without an argument it lists 
the subset hard disk Graphics DOS commands on your 
console. If you use one of the commands as an 
argument, the command syntax is displayed on your 
console. The syntax of the HE (HElp) command is: 

HE { {command] } 

where: command is the command for which you 

need help. 

Example: 

HE CP 



CP Exit to CP/M 

This command takes you from subset hard disk GDOS 
command level back to Graphics CP/M. The syntax of 
the CP command is: 

CP 

Returns to CP/M 
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INDEX 

The manuals used with Graphics CP/M are indexed in the 
following manner. 

1. All manual references followed by a page number such as 
4-12 or 1-5, etc. f refer to the North Star ADVANTAGE 
Graphics CP/M Preface. 

2. All manual references followed by a page number such as 
AUG-4, IN-5, etc. f refer to one of the seven Digital 
Research Manuals. In this case, AUG-4 points to page 4 
of the "Assembler Users Guide" while IN-5 refers to 
page 5 of the "Introduction to CP/M Features and 
Facilities". See the list below for the abbreviations 
used for each of these manuals. 



IN = An Introduction to CP/M Features and Facilities 

UG = CP/M 2.2 User's Guide 

ED = ED: A Context Editor for the CP/M Disk System 

User's Manual 
AUG = CP/M Assembler User's Guide 
AG = CP/M 2 Alteration Guide 
IG = CP/M 2 Interface Guide 
DDT = Dynamic Debugging Tool (DDT) User's Guide 
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INDEX 

A(ssemble) command, DDT-3 

assembly language reference card, DDT-3 
insert inline assembly language, DDT-3 
Abort PIP copy, IN-22 
ADVANTAGE 

floppy disk 
BDOS, 8-1 

BIOS-disk portion, 8-1 
BIOS-upper portion, 8-1 
buffer and scratch, 8-1 
Console Command Processor (CCP) , 8-1 
disk map, 8-1 
DOS Directory, 8-1 
Graphics CP/M Bootstrap, 8-1 
patching, 8-1 
start-up, 2-1 
USER-Sequential I/O, 8-1 
hard disk 
BDOS, 9-9 

BDOS - upper portion, 9-9 
buffer and scratch space, 9-9 
Console Command Processor (CCP) , 9-9 
CP/M bootstrap, 9-9 
create SYSTEM account, 3-1 
disk map, 9-9 
ADVANTAGE (continued) 
hard disk 

DOS directory, 9-9 
patching, 9-9 
- ^SBIOS, 9-9 

special system area, 9-9 
start-up, 3-1 
test and format, 3-1 
HARD DISK SUPPLEMENT 
Diskette, 3-1 
Guide, 3-1 
pixel dimensions, 6-12 
Alloc - command argument, 10-3 
Allocation 

disk directory, 9-4 
logical drive, 9-4 
Alternate character set, 6-26 
character entry, 6-26 
character grid, 6-26 
descenders, 6-27 
table, 6-26 
Ambiguous file references, IN-4 
Arcs, 6-19 

Arithmetic and logic instructions, AUG-15 
Arithmetic operators, AUG-6 
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INDEX (Continued) 

ASM 

translate assembler source to' .HEX, 5-8 
Assembler directives, AUG-8 
Assembler error codes and messages, AUG-16 
Assembler fields, AUG-2 

comment, AUG-3 

label, AUG-3 

line #, AUG-3 

operand, AUG-3 

operation code, AUG-3, AUG-12 
Assembler filename conventions, AUG-1 
Assembler initiation, AUG-1 
Assembler program format, AUG-2 
Assembler redirect for I/O files, AUG-1 
Assembler sample session, AUG-17, AUG-18 
Auto-start, 8-3 

Option bit address, 8-2 

user program, 8-4 
Auto-wraparound off 

ESC %, 6-9 
Auto-wraparound on 

ESC $, 6-9 
AUT0.COM, 8-3 

BACKSPACE, 5-3 

CONTROL-H, 6-6 
Backup 

CP/M system diskette, 2-7 

PRN file as source, IN-17 
BAD SECTOR 

BDOS error, IN-33 
Basic Disk Operating System (BDOS) , IN-1 
Basic I/O System (BIOS) , IN-1 
Batch CP/M 

commands, IN-28 
BDOS, IN-1, IG-1 

error messages, IN-33 
BDOS error messages, IN-33 
BDOS primitive operations, IN-2 
Bell tone 

CONTROL-G, 6-6 
BIOS, IN-1, IG-1 

access OPTION byte, 8-4 

changes in Version 2.0, UG-28 

Disk parameter block, UG-1 
BLOCK, 6-12 

command byte structure, 6-22 

deblocking information, UG-1 

disk parameter, UG-1 

move rectangular array between RAM and screen, 6-24 
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INDEX (Continued) 

Block address 

16 bit, 9-5 

8 bit, 9-5 
Block size 

hard disk, 9-6 
BOOT, IG-1 
Built-in commands, 4-1, 5-1, 5-2, 5-3, IN-3 

form of, IN-7 

USER, UG-4 

Call and Return instructions, AUG-13 
CBASE, IG-1 

CCP, 4-1, 4-3, 5-1, IN-1, IN-2, IG-4 
command line length, IN-11 
directory display, UG-2 
interface to storage device, IG-1 
line editing functions 
CONTROL-C, IN-11 
CONTROL-E, IN-11 
CONTROL-P, IN-11 
CONTROL-R, IN-11 
CONTROL-S, IN-11 
CONTROL-U, IN-11 
CONTROL-X, IN-11 
CONTROL-Z, IN-11 
RUBOUT, IN-11 
login function, UG-2 
translate case, IG-7 
user number, UG-4 
CHAR, 6-12 

command byte structure, 6-22 
draw characters to screen, 6-25 
Character I/O subsystem, 6-3, 6-4 
Circle, 6-19 
CLEAR, 6-12 

clear screen scroll to line 0, 6-23 
Clear to end of line 

CONTROL-N, 6-7 
Clear to end of screen 

CONTROL-O, 6-7 
CLOSE, IN-2 

Close File (Function 16) , IG-16 
COLDBOOT utility, 6-1 

change operating system, 4-3 
floppy disk ADVANTAGE, 2-7 
hard disk ADVANTAGE, 3-9 
Command arguments, 10-1, 10-2, 10-3, 10-4 
Command byte, 6-13 

geometric routines, 6-14 
non-geometric routines, 6-22 



ADVANTAGE Index-5 Graphics CP/M Preface 



INDEX (Continued) 

Command line 

multiple files, IN-19 
Compute File Size (Function 35) , IG-28 

revised, UG-19 
Connections 

hard disk, 9-1 
adding, 9-3 
deleting, 9-3 
floppy disk, 3-14 
Graphics DOS files, 3-9 
HDBOOT, 3-13 
HDBOOT summary, 3-13 
permanent, 9-2 
replace, 9-3 
reviewing, 3-14, 9-3 
saving, 3-14 

write to hard disk workfile, 3-14 
Console Command Processor, 4-1, see CCP 
Console Command Processor (CCP) , IN-1 
Console Input (Function 1) , IG-8 
Console Output (Function 2), IG-8 
Control characters, UG-3 

entering, 5-3 
CONTROL-A 

accept bad data, 7-2 
reverse video on, 6-5 

set A register to force acceptance, 8-5 
CONTROL-B 

reverse video off, 6-5 
CONTROL-C, 6-5, IN-11, DDT-2 
exit from LOCAL, 6-4 
return control to CCP, 4-3 
set register A for warm-boot, 8-5 
transfer command to CCP, 5-4 
warm-boot, 2-6, 4-3, 8-4 
warm-boot after diskette error, 7-2 
CONTROL-D 

video reset, 6-5 

CONTROL-E, IN-11 

keyboard audio feedback on, 6-5 
CONTROL-F 

keyboard audio feedback off, 6-5 
CONTROL-G 

bell tone, 6-6 
CONTROL-H 

backspace, 6-6 

destructive backspace, 6-11 
CONTROL-J 

linefeed, 6-6 
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INDEX (Continued) 



CONTROL-K 

reverse line feed, 6-6 
CONTROL-L 

forward space, 6-7 
CONTROL-M 

return, 6-7 
CONTROL-N 

clear to end of line, 6-7 
CONTROL-0 

clear to end of screen, 6-7 
CONTROL-P, 6-7, IN-11 

stop/start printer, 5-4 
CONTROL-Q 

smooth scrolling on fast, 6-7 
CONTROL-R, IN-11 

hybrid mode on, 6-8 
CONTROL-S, IN-11 

hybrid mode off, 6-8 

stop/start console output, 5-4 
CONTROL-T 

smooth scrolling on, 6-8 
CONTROL-U, IN-11 

smooth scrolling off, 6-8 
CONTROL-X, IN-11 

cursor on, 6-8 

erase line, 5-4 
CONTROL-Y 

cursor off, 6-9 
CONTROL-Z, IN-11 
CONTROL-X 

screen on, 6-9 
CONTROL-] 

screen off, 6-9 
CONTROL-" 

home cursor, 6-9 
CONTROL-_ 

new line, 6-9 
COPY utility, 6-1 

ONECOPY for hard disk copy, 4-3 

surface check for errors, 7-2 

system diskette, 2-8 
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INDEX (Continued) 

CP 

return to CP/M command, 10-9 
CP/M 

assembler, AUG-1 

BIOS changes in Version 2.0, UG-28 

built-in commands, 5-1 

connections to hard disk Graphics DOS, 9-1 

CP command, 10-9 

File Control Block (FCB) , IG-5 

function names (list) , IG-4 

memory organization, UG-27, IG-1 

optional software, IN-1 

overlay subsystems, IN-2 

overview, 5-1 

return from Graphics DOS (hard disk subset), 10-1 

software, IN-1 

system diskette, 2-1, 3-2 
backup, 2-7 

utility programs, 5-4 

working session, 4-1 
CPMGEN, 2-3, 3-4 

abort program, 2-4, 3-5 

baud rate for serial printers, 2-6, 3-6 

hard disk, 3-5 
pathname, 3-6 

memory size, 2-4 

read-af ter-write check, 2-5, 3-6 

restart, 2-4, 2-6, 3-5, 3-7 

specify floppy disk drive capacity, 2-4 
CPMGEN utility, 6-1 
CPMWORK 

default workfile name, 3-6, 3-10, 3-13, 9-2 
CR 

Create File command, 10-5 
CRC, see Cyclic redundancy check 
Create File command 

CR, 10-5 
Cursor off 

CONTROL-Y, 6-9 
Cursor on 

CONTROL-X, 6-8 
Cyclic redundancy check (CRC) , ED-13 

D(isplay) command - show memory in hex or ASCII, DDT-4 
Data movement instructions, AUG-15 
DB, assembler directive, AUG-11 
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INDEX (Continued) 



DDT 

assembler/disassembler location, DDT-9 

automatic load f DDT-1 

commands, DDT-2, DDT-5, DDT-6, DDT-7, DDT-8, DDT-9 
execute after carriage return, DDT-2 
list of types, DDT-2 
prompt, DDT-3 
return control to, DDT-3 

control character use, DDT-2 

CPU state, DDT-3 

debug and patch, 5-8 
DDT (continued) 

determine number of memory pages, DDT-2 

GO, DDT-2 

initiate, DDT-1 

line-edit, DDT-2 

overlay non-essential portions, DDT-9 

sample program, DDT-10 

sign-on, DDT-1 

Transient commands, IN-12 

use with SYSGEN, 8-4 
DE 

Delete file command, 10-6 
DELETE 

destructive backspace, 6-11 
Delete File (Function 19) , IG-18 

revised, UG-15 
Delete File command 

DE, 10-6 
Delete line 

ESC M or ESC m, 6-10 
Descenders, 6-27 
DESPOOL, UG-29 
Destructive backspace 

DELETE, 6-11 
DIB, 10-3 
Digital Research, 1-1, 5-1 

manuals, 1-1 
DIR(ectory) command, 5-1, IN-3, IN-8 
DIRDUMP utility, 6-2 
Direct Console I/O (Function 6) , IG-10 

revised, UG-12 
Direct cursor addressing 

ESC Y X, 6-10 
Direct Memory Address, IG-21 
Directives, Assembler, AUG-8 
Directory listings, 10-7 
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INDEX (Continued) 

Directory size, UG-1 
Disk 

logged-in, IN-3, IN-6 
Disk drive 

designation, 4-2 
using a file from another, 4-2 
Disk map of locations by component 
floppy disk ADVANTAGE, 8-1 
hard disk ADVANTAGE, 9-9 
Disk parameter block, UG-1 
DISKDEF, UG-29 

form of call, UG-30 
parameters, UG-30 
DISKERR 

intercepting errors, 8-5 
Diskette 

ADVANTAGE HARD DISK SUPPLEMENT, 3-1 
capacity 

dual, 4-4 
Diskette (continued) 

ADVANTAGE HARD DISK SUPPLEMENT, 3-1 
capacity 

quad, 4-4 
copy system, 2-8 
CP/M system, 2-1, 3-2 
backup, 2-7 
erasure, 5-8 
insert, 2-1, 3-2 
CP/M working copies 

customize with CPMGEN, 2-3 
selective erasure, 5-9 
error messages, 7-1 
format, 7-1 

read/write new diskette, 7-3 
error recovery, 7-2 

FORMAT blank, 2-2, 3-2, 3-3, 3-4, 4-3 
handling, 2-1 
initialize for CP/M, 2-2 
system 

customize with CPMGEN, 3-4 
DISKS macro, UG-31 
Display Hard Disk Statistics command 

ST, 10-8 
DMA 

set value for Direct Memory Address, IG-21 
DPBASE, UG-31 

Drive number - command argument, 10-3 
DS, assembler directive, AUG-12 
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INDEX (Continued) 



DUMP 

display contents of file in hex, 5-8 

Transient commands, IN-12 
DW, assembler directive, AUG-12 

E(xamine) command 

CPU registers, DDT-8, DDT-9 

display and alter CPU state, DDT-8 
ED 

character pointer, ED-5 

character pointer commands, ED-6, ED-7 

command strings, ED-7 

command summary, ED-15 

context editor, IN-25 

control character summary, ED-14 

Digital Research text editor, 5-8 

enhancements, UG-10 

error conditions, ED-13 

include source libraries, ED-11 

initiation, ED-1 

insert text, ED-5, ED-9 

macro command, ED-12 

memory buffer, ED-5 

memory buffer organization, ED-3 

operation, ED-1 

repetitive command execution, ED-12 

simple string substitutions, ED-10 

source file organization, ED-3 

temporary file organization, ED-3 

text alteration, ED-8 

text search, ED-8 

transfer functions, ED-1, ED-4 

Transient commands, IN-12 
ELLIPSE, 6-12, 6-19 
END, assembler directive, AUG-9 
ENDEF macro 

define uninitialized data areas, UG-32 
ENDIF, assembler directive, AUG-10 
EQU, assembler directive, AUG-9 
ERA(se) command, IN-3, IN-7 

erase files, 5-3 

selective erasure, 5-9 
Error codes and messages 

assembler, AUG-16 
Errors 

intercepting, 8-5 

messages 

diskette, 7-1, 7-3 

substitute message, 8-5 
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ESC $ 

auto-wraparound on, 6-9 
ESC % 

auto-wraparound off, 6-9 
ESC L or ESC 1 (lower case) 

insert line, 6-10 
ESC M or ESC m (lower case) 

delete line, 6-10 
ESC Y X 

direct cursor addressing, 6-10 
Extents 

file expansion, UG-1 

F(ill) command - set memory block to constant value, DDT-4 

FBASE, IG-1 

FCB 

File Control Block, IG-5 

format, IG-6 

Make file (Function 22), IG-7 

storage in directory, IG-7 
FCB and Open file (Function 15), IG-7 
FDOS 

combination of BIOS and BDOS, IG-1 
File 

attributes, 10-8 

expansion, UG-1 

indicators (set or reset) , UG-6 

size, UG-1 

structure, IN-1 
File Control Block (FCB) , IG-5 
File definition, IG-5 
FDOS (continued) 
File management, IN-1 
File name, 4-4 

ambiguous (af n) , IN-3, IN-4 

assembler conventions, AUG-1 

directory search, IN-4 

extension, 4-4 

hard disk, 10-3 

multiple files, 4-5 

pattern match, IN-4 

primary, 4-4, IN-4 

secondary, IN-4 

specified with disk drive name, IN-5 

unambiguous (ufn) , IN-3, IN-4 

wild carding, 4-5 
File names, IG-4 
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File structure, IG-4 
File subsystem, IN-1 

dynamic allocation of file space, IN-1 

random access, IN-1 

sequential access, IN-1 
File types - generic (list) , IG-5 
Floppy disk drive 

capacity, 2-4, 3-5 

stepping speed, 2-5, 3-5 
FORMAT utility, 2-2, 3-2, 6-1 
Forward space 

CONTROL-L, 6-7 
Function Name 

Close File (Function 16), IG-16 

Compute file size (Function 35), UG-19, IG-28 

Console Input (Function 1), IG-8 

Console Output (Function 2) , IG-8 

delete file (Function 19), UG-15, IG-18 

Direct console I/O (Function 6), UG-12, IG-10 

Get ADDR (Alloc) (Function 27), IG-22 

Get ADDR (Disk Parms) (Function 31), IG-24 

Get Console Status (Function 11), IG-13 

Get disk parameter block address (Function 31) , UG-17 

Get I/O Byte (Function 7), IG-11 

get H/O vector (Function 29) , UG-16 

Get Read/Only Vector (Function 29) , IG-23 

List Output (Function 5) , IG-9 

Make File (Function 22), IG-19 

open file (Function 15), UG-14, IG-15 

Print String (Function 9) , IG-11 

Punch Output (Function 4) , IG-9 

Read console buffer (Function 10), UG-13, IG-12 

Read random (Function 33), UG-17, IG-25 

Read Sequential (Function 20), IG-18 

Reader Input (Function 3) , IG-9 

rename file (Function 23), UG-16, IG-20 

Reset Disk System (Function 13) , IG-14 

Return Current Disk (Function 25) , IG-21 

return login vector (Function 24) , UG-16, IG-20 

Return version number (Function 12), UG-13, IG-13 

Sample programs 

set random record, UG-20 

search for first (Function 17), UG-15, IG-17 

search for next (Function 18) , UG-15, IG-17 

Select Disk (Function 14) , IG-14 

Set DMA Address (Function 26), IG-21 
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Set file attributes (Function 30) , UG-16, IG-23 

Set I/O Byte (Function 8) , IG-11 

Set random record (Function 36) , UG-19, IG-29 

sample program, UG-20 

sample program listing, UG-21 
Set/Get User code (Function 32), UG-17, IG-24 
System Reset (Function 0) , IG-8 
write protect disk (Function 28), UG-16, IG-22 
Write random (Function 34), UG-18, IG-27 
Write Sequential (Function 21) , IG-19 

G(o) command - start program execution, DDT-4 

GDDT utility, 6-2 

GDOS, s_££ Graphics DOS or Graphics DOS (hard disk subset) 

Geometric routines, 6-12, 6-13, 6-16, 6-17, 6-19, 6-21 

Get ADDR (Alloc) (Function 27), IG-22 

Get ADDR (Disk Parms) (Function 31) , IG-24 

Get Console Status (Function 11) , IG-13 

Get disk parameter block address (Function 31) 

revised, UG-17 
Get I/O Byte (Function 7) , IG-11 
Get R/O vector (Function 29) 

revised, UG-16 
Get Read/Only Vector (Function 29) , IG-23 
GMGRADD 

append graphics subsystem to .COM file, 6-12 
GMGRADD utility, 6-1 

Graphic support routines, 6-12, 6-22, 6-23, 6-24, 6-25 
Graphics DOS, 9-2 
accounts, 9-4 
command arguments, 10-1 
command prompt, 3-12 
complete hard disk, 3-9 
CReate units, 3-12 

establish connections to logical drives, 3-9 
file names, 9-1 
hard disk subset, 3-10, 9-2 
command arguments, 10-2 
Command Processor, 10-1 
Create File command, 10-5 
create/delete CP/M units, 10-1 
Delete File command, 10-6 

display hard disk statistics command, 10-8 
Help, 10-1 
Help command, 10-9 

Jump to a RAM address command, 10-7 
list file directory, 10-1 
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hard disk subset 

List File Directory command, 10-7 

list hard disk statistics, 10-1 

return to CP/M, 10-1 

return to CP/M command, 10-9 

Set Length command, 10-6 
Graphics subsystem, 6-12 

alternate character set, 6-26 

command byte, 6-13 

GMGRADD, 6-12 

include in programs, 6-12 

Hard disk 

block size, 9-6 

CPMGEN, 3-5 

pathname, 3-6 

increasing logical drive capacity, 9-6 

ONECOPY CP/M files onto working copy, 3-8 

shutdown, 3-16 
Hard disk connections, see Connections 
Hard Disk Supplement Diskette, 3-1 
Hard Disk Supplement Guide, 3-1 
HDBOOT, 3-13 
HDOFF 

shut down hard disk, 3-16 
HE 

Help command, 10-9 
Help command 

HE, 10-9 
Home cursor 

CONTROL-", 6-9 
Hybrid mode off 

CONTROL-S, 6-8 
Hybrid mode on 

CONTROL-R, 6-8 

I(nput) command - insert file name in default control block, DDT-5 

I/O device number, 10-2 

IF, assembler directive, AUG-10 

Immediate operand instructions, AUG-14 

Increment and decrement instructions, AUG-14 

Insert line 

ESC L or ESC 1 (lower case), 6-10 
Interior shading, 6-13 



INDEX (Continued) 
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JP 

Jump to a RAM Address, 10-7 
Jump, AUG-13 
Jump table, 8-2 
Jump to a RAM address command 

JP, 10-7 

Keyboard audio feedback off 

CONTROL-F, 6-6 
Keyboard audio feedback on 

CONTROL-E, 6-5 

L(ist) command - list assembly mnemonics, DDT-6 

Label value, AUG-4 

Len - command argument, 10-3 

LI 

List File Directory command, 10-7 
Linefeed 

CONTROL- J, 6-6 
List file directory 

file attributes, 10-8 
List File Directory command 

LI, 10-7 
List Output (Function 5) , IG-9 
LOAD 

translate .HEX file into .COM file, 5-8 
LOCAL, 6-4 
LOCAL utility, 6-1 
Logged disk 

assumed, IN-19 
Logged-in disk, IN-3 

changing, IN-6 
Logical drive, 3-9, 9-1 

allocation, 9-4 

block size, 9-1, 9-5 

increase capacity, 9-6 

more than one, 9-3 

total size, 9-1 
Logical drives 

16 bit, 9-6 

8 bit, 9-6 
Logical operators, AUG-6 
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M(ove) command - block move to different location, DDT-6 

Make File (Function 22) , IG-19 

Manuals 

Digital Research, 1-1 

Intel assembler, AUG-14 
Memory size, 2-4, 3-5 
MOVCPM, IN-12, IN-30 
Multiple files, IN-19 

New line 

CONTROL-.., 6-9 
Numeric constants, AUG-4, AUG-5 

ONECOPY utility, 6-1 

copy for hard disk, 4-3 

diskette changes, 3-8 

load CP/M utility files onto working copy, 3-8 
OPEN, IN-2 
Open File (Function 15), IG-15 

revised, UG-14 
Operating systems 

change, 4-3 
Operation code 

arithmetic and logic instructions, AUG-15 

Call and Return instructions, AUG-13 

control instructions, AUG-16 

data movement instructions, AUG-15 

immediate operand instructions, AUG-14 

increment and decrement instructions, AUG-14 

Jump, AUG-13 
operator precedence, AUG-7 
OPTION byte 

BIOS, 8-4 
ORG, assembler directive, AUG-8 
Overlay DDT, see DDT - overlay non-essential portions 

Patching 

auto-start, 8-3 
change AUTO command, 8-3 
DDT with SYSGEN, 8-4 
disk BIOS locations, 8-2 
floppy disk ADVANTAGE, 8-1 
hard disk ADVANTAGE, 9-9 
SYSGEN, 8-3, 8-4 
system procedure, 8-3 
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Pathname - command argument, 10-3 

Perimeter, 5-13 

Peripheral Interchange Program, see PIP 

Pie slice, 6-19 

PIP, IN-18 

abort copy, IN-22 
additional device 

EOF:, IN-21 

INP:, IN-21 

OUT:, IN-21 

PRN:, IN-21 
additional device names 

NUL:, IN-21 
concatenation, IN-21 
copy all files on disk, 5-7 
copy file and rename, 5-7 
copy files, 5-6 

copy multiple files with file matches, 5-7 
copy parameters, IN-23, IN-24 
C0 PY portion of file, 5-7 
copy single file, 5-7 
enhancements, UG-8 

Gn (Get file from User number n) , UG-8 

R (Read system files) , UG-8 

W (Write over R/0 files), UG-8 
error checking on .HEX write to peripheral, IN-22 
executing, 5-6 
list file to printer, 5-8 

load CP/M utility files onto working copy, 2-6 
logical devices, IN-20 

CON: (console), IN-20 

LST: (list) , IN-20 

PUN: (punch), IN-20 

RDR: (reader), IN-20 
multiple files, IN-19 
physical devices, IN-20 

CRT:, IN-21 

LPT:, IN-21 

PTP:, IN-21 

PTR:, IN-21 

TTY:, IN-21 

UC1, IN-21 

UL1, IN-21 

UP1:, IN-21 

UP2:, IN-21 

UR1:, IN-21 

UR2:, IN-21 
retain on CP/M working copy, 5-9 
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Transient commands , IN-12 

unambiguous destination, IN-19 

unambiguous source, IN-19 
POLYGON, 6-12, 6-17 

lines, 6-17 

many-sided figures, 6-17 

points, 6-17 
Precedence, see Operator precedence 
Print String (Function 9) , IG-11 
Printers 

baud rate at CPMGEN, 3-6 
Program counter, DDT, DDT-3 
Punch Output (Function 4) , IG-9 

R(ead) command 

read .COM or .HEX file into TPA, DDT-6 

with I(nput) command, DDT-6 
Raddr, 10-4 

Radix indicators, AUG-4, AUG-5 
RAM 

image locations, 8-1, 9-9 
Random record 

set position from file, IG-29 
READ, IN-2 
Read Console Buffer (Function 10), IG-12 

revised, UG-13 
READ ONLY 

BDOS error, IN-33 
Read Random (Function 33) , IG-25 

revised, UG-17 
Read Sequential (Function 20), IG-18 
Reader Input (Function 3) , IG-9 
RECTANGLE, 6-12, 6-16 

draw rectangle, 6-16 

set viewport, 6-16 
Register 

C, 6-13 

HL, 6-13 
REN(ame) command, IN-3, IN-8 

rename files, 5-2 
RENAME, IN-2 
Rename File (Function 23) , IG-20 

revised, UG-16 
Reserved character values, AUG-5 
Reserved characters, AUG-5 
Reset Disk System (Function 13), IG-14 
RETURN, 5-4, 10-1 

CONTROL-M, 6-7 
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Return Current Disk (Function 25) , IG-21 
Return Login Vector (Function 24) , IG-20 

revised, UG-16 
Return Version Number (Function 12) , IG-13 

revised, UG-13 
Reverse line feed 

CONTROL-K, 6-6 
Reverse video off 

CONTROL-B, 6-5 
Reverse video on 

CONTROL- A , 6-5 
RUBOUT, IN-11 

S(et) command - examine and alter memory locations, DDT-7 
Sample program 

edit, assemble, and debug, DDT-10 
Sample Programs 

file dump utility, IG-34 

file-to-file copy, IG-30 

set random record, UG-20 
Sample session 

assemble and debug, AUG-17, AUG-18 
SAVE command, IN-3, IN-9, UG-4 
Screen off 

CONTROL-] , 6-9 
Screen on 

CONTROL- \, 6-9 
SEARCH, IN-2 
Search for First (Function 17), IG-17 

revised, UG-15 
Search for Next (Function 18) , IG-17 

revised, UG-15 
SECTRAN subroutine, UG-32 
SELDSK subroutine, UG-32 
SELECT, IN-2 

BDOS error, IN-33 
Select Disk (Function 14) , IG-14 
Selective erasure 

utility programs, 5-9 
Set DMA Address (Function 26), IG-21 
Set File Attributes (Function 30), IG-23 

revised, UG-16 
Set I/O Byte (Function 8) , IG-11 
Set Length command 

SL, 10-6 
Set Random Record (Function 36), IG-29 

revised, UG-19 

sample program, UG-20 

sample program listing, UG-21 
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SET, assembler directive, AUG-10 
Set/Get User Code (Function 32), IG-24 

revised, UG-17 
SL 

Set Length command, 10-6 
Smooth scrolling on 

CONTROL-T, 6-8 
Smooth scrolling on fast 

CONTROL-Q, 6-7 
Smooth scrooling off 

CONTROL-U, 6-8 
SPECIAL LINE, 6-12, 6-21 
ST 

Display Hard Disk Statistics command, 10-8 
Stack pointer, DDT, DDT-3 
Start-up 

floppy disk ADVANTAGE, 2-1 

hard disk ADVANTAGE, 3-1 
STAT, IN-13, IN-14, IN-15 

change file status, 5-5 

d:DSK, UG-6 

disk bytes remaining, 5-5 

display User numbers, UG-7 

DSK:, UG-7 

eliminate directory listing, 5-6 

file status, 5-5 

retain on CP/M working copy, 5-9 

set all files Read/Only, 5-6 

set or reset file indicators, UG-6 

space on logical drive, 3-15 

USR: , UG-7 
Statements, Assembler, AUG-8 
Statistics 

Hard Disk, 10-8 
String constants, AUG-6 
SUBMIT, IN-28 

command batching, 5-8 

extension using XSUB, UG-11 

substitute parameters, IN-28, IN-^29 

Transient commands, IN-12 
Subset Graphics DOS, see Graphics DOS (hard disk subset) 
Subtended chord, 6-19 
Summary 

ED commands, ED-15 
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SYSGEN, 3-5, 3-9, 5-9, 8-3, 8-4, IN-27 

copy system area, 5-7 

Digital Research standard CP/M, AG-2 

move CP/M system between memory and diskette, 5-8 

Transient commands, IN-12 
SYSGEN utility, 6-2 
System I/O calls, IG-3 
System Reset (Function 0), IG-8 
System tracks, 4-1 

T(race) command - trace program execution, DDT-7 
TBASE, IG-1 
TPA, IN-1, IN-2, IG-1 
command lines, IG-2 

default file control block area, IG-5 
load and execute programs for check out, IN-2 
use of I/O facilities to communicate, IG-2 
Transient commands, IN-17 
ASM, IN-12, IN-16 

PRN file, IN-16 
DDT, IN-12 
DUMP, IN-12 
ED, IN-12 
LOAD, IN-12 
MOVCPM, IN-12, IN-30 
PIP, IN-12, IN-18, UG-1 
enhancements, UG-8 

Gn (Get file from User number n) , UG-8 
R (Read system files) , UG-8 
W (Write over R/O files), UG-8 
STAT, IN-12, IN-13, UG-1, UG-6, UG-7 

enhancements, UG-5 
SUBMIT, IN-12, IN-28 
file name, IN-29 
substitute parameters, IN-29 
SYSGEN, IN-12, IN-27 
XSUB, UG-11 
Transient Programming Area, see TPA 
TYPE command, IN-3, IN-9, IN-10 
print a file, 5-2 
review text, 5-2 
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U(ntrace) command - no display of intermediate steps in tracer DDT-8 

Unambiguous file references, IN-4 

Units 

CReate hard disk, 3-12 
hard disk, 3-11 
User area 

jump table, 8-2 

replace for non-standard sequential devices, 8-6 
USER command, UG-4 
User number, UG-1, UG-4 
USER. ASM, 6-2 
Utilities, 4-1 

North Star, 6-1 
COLDBOOT, 6-1 
COPY, 6-1 
CPMGEN, 6-1 
DIRDUMP, 6-2 
FORMAT, 6-1 
GDDT, 6-2 
GMGRADD, 6-1 
LOCAL, 6-1 
ONECOPY, 6-1 
SYSGEN, 6-2 
USER. ASM, 6-2 
PIP, 5-6 
STAT, 5-5 

Video control codes, 6-5, see Control characters and Escape codes 
Video reset 

CONTROL-D, 6-5 
Viewport, 6-12 

Warm-boot 

reset disk subsystems, 4-3 
Workfile, 9-2 
WRITE, IN-2 
Write Protect Disk (Function 28) , IG-22 

revised, UG-16 
Write Random (Function 34) , IG-27 

revised, UG-18 
Write Sequential (Function 21) , IG-19 
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